4 ms·
That’s my experience with any of the 3 hyperscalers when reading docs. Millions of versions, blog posts and just overall massive challenge to get to the root of
by infecto 1mo ago
That’s my experience with any of the 3 hyperscalers when reading docs. Millions of versions, blog posts and just overall massive challenge to get to the root of it. Funny the one thing I was always able to immediately and quickly digest, AWS Textract because they have a great python library with the kind of documentation I expect from a python project.
- automatic6131 1mo agoDocumentation clearly following Conway's law: shipping the org chart.
- disgruntledphd2 1mo ago> That’s my experience with any of the 3 hyperscalers when reading docs. I used to hate the AWS docs, now I use Azure and I hate that so much more. At least AWS had loads of (bad) docs that you could string together to figure out how to do something. With Azure, there's just no docs (except for bad videos), and they literally tell you (at the top of every page) that you can do this with AI (I know I can do it with AI, but I'd prefer if I could read your docs to make sure the machine isn't doing something dumb). My expectation is that I'll end up on GCP in a few years, and that will be bad in hilariously different ways.
- abofh 1mo agoYes, gcp has volumes of available accurate documentation, but it's almost entirely incomprehensible and bizarrely undiscoverable by search
- ferngodfather 1mo agoIf only they had a parent company that specialised in search
- alasdair_ 1mo agoGCP is famous for having two ways to do everything: the undocumented way and the deprecated way. You choose.
- disgruntledphd2 1mo agoI've been making this joke about Google (big tech in general) for years. There are two ways to do everything; one is deprecated and the other is not yet feature complete. Glad to know that they're allowing their customers a taste of what it's like to work at Google.
- vrosas 1mo agoI feel like I'm the only person on HN that doesn't have any major (or cliche) problems with GCP, even after using it for a decade at this point. Like it's not perfect and I've hit weird roadblocks along the way but I've dabbled AWS and I currently use Azure at work and those are hilariously bad in their own ways, people just seem to kind of be used to it?
- deleted 1mo ago[deleted]
- antonvs 1mo agoI like GCP as well, having previously used AWS for many years. The biggest issue is that it's taken Google a long time to figure out what enterprise security is - it's not something what was in their DNA - and the product shows it. They're too focused on weird fancy half-assed "beyond" solutions to properly implement the basics. They dangle clever federated etc. solutions that only work in some circumstances so that you're better off just avoiding them, but the more basic alternatives are limited in their own way because they focus too much on the fancier solutions.
- icedchai 1mo agoI find GCP's developer experience to be superior to AWS. Maybe it's just me, but I found Cloud Run to be super simple to use compared to ECS/Fargate. The "gcloud" command structure also makes more sense to me.
- disgruntledphd2 1mo agoI haven't used much GCP, I'm just being snarky.
- creamyhorror 1mo agoYep, if someone thinks AWS docs are rough, wait till they try Azure docs!
- soco 1mo agoThe Azure documentation is learn.microsoft.com, I'm not sure why you mean there's nothing (or only videos). Just saying.
- mlinhares 1mo agoNo one gets promoted for writing good docs.
- Spooky23 1mo agoThey get promoted for fucking with them. We were in the middle of a big fight with Microsoft support over a product defect. They literally updated the product docs in realtime and revised the sizing guidance for the product to be about 5% under our sizing. It was too specific a number to be a coincidence. We were at war with them, so the team was capturing the documentation and timestamping it. They gaslit us to run the clock so the product would slide outside of mainstream support.
- mixedbit 1mo agoMy experience with Boto: need some S3 manipulation logic, here is an official documentation that shows how to solve the exact problem with Boto, one caveat, this version of Boto is deprecated. Do the same with the newest version? Not possible.
- sandeepkd 1mo agoI do not really want to defend any of the companies here but the reality is that documentation is always a thankless job. People do it to get their project out there, get limelight and move on. There is not much incentive for the teams to manage the documentation actively unless the its a business priority. I am myself in the IDP business, was trying to understand the pain points of the user. Even though I am not big fan of AWS but I find that the concerns are baked into the hope that using an IDP would some how make is very easy > Flexibility of doing local development while on plane Really depends what you are expecting from the IDP but personally this is one off situation and in most cases its not worth solving. We are in such a interconnected or dependent state where local development without internet is really hard. > Configuration issue The features of a solution are two edged sword, it provides people options to tailor it for their own use case and yet at the same time it adds to the learning curve. Good default might have been useful here, however it looks like Author only wanted email and nothing else so it was a departure from defaults > UI customization A lot of providers allow some flexibility with the UI but not a whole lot. And then some allow you to host on your website and call the API's for the authentication flows using SDK. Personally this one is tricky, its a UX vs security topic. As a thumb rule never trust the client. The request headers and ability to interact with browsers are what provides you with relatively better state and session control. As an IDP provider I do not want to loose that and still be on the hook for security.
- swyx 1mo ago> As a thumb rule never trust the client. The request headers and ability to interact with browsers are what provides you with relatively better state and session control. As an IDP provider I do not want to loose that and still be on the hook for security. ok so why NOT allow extreme ui customization since client is untrusted anyway? i dont get it. theres no security concern (within this ui) bc the whole thing is untrusted.