They’re the absolute worst. Doc links will go in circles, redirecting you back to where you just were, API documentation is out of date - or worse it’s out of date and doesn’t tell you until the end of reading if it even tells you at all.
Not even mentioning how everything is in permanent “alpha” and “beta” state. Things are never finalized so they can get away with changing the definition on a whim and say “sorry it was in beta, now it’s in beta5”. I had to rewrite Pub/Sub code at least once a month because they changed their spec on that, and that was one of their “most finalized” products.
Fuck GCP, I will actively avoid jobs that code on it now. If you want enterprise customers, provide an enterprise product. This isn’t chat where you can rebuild it every year because your marketers are bored. These are enterprise products that companies depend on.
Doc links will go in circles, redirecting you back to where you just were
Right? Who the fuck created this standard? You’ll arrive at a doc trying to figure out how to get somewhere and it’ll tell you everything except for how to actually get there. It’ll finally have a link with the link text being the name of the section you’re trying to find, but noooo… It doesn’t actually link there, it links to a second document explaining the fucking history of that section, why they named it what they did, the engineer’s dog’s puppy’s name, and anything else to fluff out the doc without actually being useful. Why in the hell would you write a doc about an interface and not link to the relevant interface? I guess it’s probably because they completely rebuilt the way that website interfaces work and you can’t actually bookmark or deep link to anything. You always end up at the same page regardless of what you bookmark and then you have to manually navigate there. They took all the wonderful working features of the internet and broke them, then made alternatives that are 1000x worse.
I’m so happy, I’m not alone anymore… this frustration was a constant dread that I felt alone, and I feel like we’re two lost souls, wandering the plane of Google’s terrible documentation, lost forever looking for the json schema for the API we need, constantly searching, never finding it.
They’re the absolute worst. Doc links will go in circles, redirecting you back to where you just were, API documentation is out of date - or worse it’s out of date and doesn’t tell you until the end of reading if it even tells you at all.
Not even mentioning how everything is in permanent “alpha” and “beta” state. Things are never finalized so they can get away with changing the definition on a whim and say “sorry it was in beta, now it’s in beta5”. I had to rewrite Pub/Sub code at least once a month because they changed their spec on that, and that was one of their “most finalized” products.
Fuck GCP, I will actively avoid jobs that code on it now. If you want enterprise customers, provide an enterprise product. This isn’t chat where you can rebuild it every year because your marketers are bored. These are enterprise products that companies depend on.
Right? Who the fuck created this standard? You’ll arrive at a doc trying to figure out how to get somewhere and it’ll tell you everything except for how to actually get there. It’ll finally have a link with the link text being the name of the section you’re trying to find, but noooo… It doesn’t actually link there, it links to a second document explaining the fucking history of that section, why they named it what they did, the engineer’s dog’s puppy’s name, and anything else to fluff out the doc without actually being useful. Why in the hell would you write a doc about an interface and not link to the relevant interface? I guess it’s probably because they completely rebuilt the way that website interfaces work and you can’t actually bookmark or deep link to anything. You always end up at the same page regardless of what you bookmark and then you have to manually navigate there. They took all the wonderful working features of the internet and broke them, then made alternatives that are 1000x worse.
I’m so happy, I’m not alone anymore… this frustration was a constant dread that I felt alone, and I feel like we’re two lost souls, wandering the plane of Google’s terrible documentation, lost forever looking for the json schema for the API we need, constantly searching, never finding it.