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
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.