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.
You are not logged in. However you can subscribe from another Fediverse account, for example Lemmy or Mastodon. To do this, paste the following into the search field of your instance: !selfhosted@lemmy.world
A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don’t control.
Rules:
Be civil: we’re here to support and learn from one another. Insults won’t be tolerated. Flame wars are frowned upon.
No spam posting.
Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it’s not obvious why your post topic revolves around selfhosting, please include details to make it clear.
Don’t duplicate the full text of your blog or github here. Just post the link for folks to click.
Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).
No trolling.
Resources:
selfh.st Newsletter and index of selfhosted software and apps
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.