Dear early adaptors to Cloud and AWS,
What AWS service are you struggling to learn? What’s painful? What’s blocking you from doing what you want to do?
Has our documentation helped? What’s lacking?
👉🏽 Send me doc links and/or detailed specifics of what you need. I'm listening.💜
~Alejandra💁🏻♀️ y Canela🐾
Top comments (33)
I find the documentation, guides, and mental model pretty straightforward for most AWS services...
I tend to find things break down around permissions, groups, and how certain things plug together. That's inherently more complex in general but definitely where I struggle the most. I suspect any major cloud infrastructure provider's major opportunity for growth is the "how things plug together" piece of things anyway.
App Mesh and Event Bridge seem like great examples of this, but don't solve the real challenge... IAM. Maybe the most interesting thing I've seen in that space is cloud recorder. A chrome extension that watches you take actions in the dashboard and outputs Terraform, limited IAM JSON, er cetera... Why doesn't AWS just have this themselves???
Wow! This exists??!
I SO agree with you, and I was actually just mentioning this to a colleague last week!
Do you have a specific group offering or service from AWS that you found the most confusing to "plug together" ? What do you think we should have done better?
Amazon Cognito!
All the documentation is there but the way it is organized, important information is hidden in subsections and there are few practical examples.
I have pieced together my own integration into my monolith but it was trial and error.
Most of the individual service documentation is great. I love the docs for boto3!
Where I find problems is when I have an issue involving several different products. An example from the past few days, I've been struggling to successfully attach a SSL certificate to a domain linked to an EC2 instance.
There's a lot of documentation around components of this, but I haven't figured out how to stitch all the components together (EC2, Certificate Manager, Route 53) to get over the last hurdle so that I can use HTTPS to access the domain using the existing documentation.
For beginners it's not intuitive at all compared to Firebase. I am more inclined to start my side/small projects with Firebase always.
Well this blew up.
I am not responding individually ATM since that will take a few days, but I am absolutely reading each and every comment. The plan is to compile the feedback that is repeated the most, and then pass it on to said teams.
I'm still listening, keep telling me how we can make it better. 💜
So, first thing: please add support for .net core on Linux for Elastic Beanstalk. I really like being able to manage most of my application through Elastic Beanstalk and get load balancers setup the way I want, though I don't like for .Net Core always having to use Windows. Sure I can go and setup everything from scratch, but it would be nice to see that I can use it also, since you support it on Windows.
The next thing is just the whole UX/UI. It feels disconnected. The feel/flow of the UI for one service doesn't at all flow the same way for different UI's.
Example: sometimes the steppers for some resources support the back button. You can click and it takes you back to previous step. Then there are times where the steppers or even different tabs do not support the back button. Click the back button and it just flat out EXITS you to a completely different UI. No warning at all. That's the thing that really frustrates me the most.
I understand that it is impossible for a platform as large as AWS to have a consistent UI all the time for services, as things change and you can't change them all at once. Though the biggest thing I ask for, is if one UI supports the back button then the rest of your UIs should also.
Thank you for explaining in such detail what you think would make it a better experience for you! I will be passing this on to the Elastic Beanstalk team.
Hope you noticed the release of .NET Core Linux support that came out this week. aws.amazon.com/blogs/developer/aws...
I actually did not. I must have missed that announcement. Thanks for bringing it up! I'll definitely have to check this out soon!
DynamoDB. It has some of the worst documentation that I've ever seen. Implementation as well is mind bogglingly complex.
Check out dynamodbbook.com (no association, just fan) - goes through so much of how/why to use dynamodb - it's a VERY different mindset than typical relational databases, and I agree the aws documentation is factual, just not functional.
Thanks for the suggestion!
In my opinion, it's best to not expect ANYTHING out of DynamoDB and start with a basic assumption that it is a key-value store. Then, you can build from there.
I'm saying this because almost every feature that I assumed worked in one way, turned out to work in another. Plus, there are so many features behaving differently in different scenarios, which, if you want to find that out, you have to go through 3 different documentation pages or blog posts.
We have an amazing DA that is currently working on improving the DynamoDB docs. He agrees with you, trust me! Thank you for this feedback, I will be passing this on to him.
I would like to add that while documentation is not an issue, sometimes what I wish itd come with are recommended values for certain properties and when does it make sense to increase and decrease it and what are the pros and cons of that.
One example being ReservedCpncurency setting on LAMBDA or VisibilityTimeout value on SQS.
Documentation would tell you that it takes an integer or a String and what it does. However, when you are developing a production level app, end user has no idea what he/she should set those values to.
I only found out about it after running into some article only. For instance, how they recommend that VisibilityTimeout setting for SQS should be set to 5 times the value of a LAMBDA function timeout value.
Itd be good to have a central repository somewhere where one can find this sort of best practices.
I have a plan to learn
AWS, In Comments users say documentations hard to follow. So Where should I Start ? Is there any Free Course ?Getting started on the cloud and AWS can absolutely feel confusing! It is a lot to learn and you are not alone.
I have started a youtube channel to help start teaching this from the very beginning. Want to take a look and see if this helps?
bit.ly/what-the-cloud
Most services are ok in isolation but it’s when you start tying them all together It gets complicated really fast!