this post was submitted on 28 Jan 2024
898 points (97.7% liked)
Programmer Humor
32558 readers
538 users here now
Post funny things about programming here! (Or just rant about your favourite programming language.)
Rules:
- Posts must be relevant to programming, programmers, or computer science.
- No NSFW content.
- Jokes must be in good taste. No hate speech, bigotry, etc.
founded 5 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
I've literally never seen a project remotely interesting that has their documentation on discord
Revanced was one. Good thing they wisen up and have documentations now, though it's just a set of .md files in their git repo.
Markdown in the repository is a pretty good way to keep documentation in sync with the source.
what is it
Modded version of youtube app that let's you kill all the ads, among many other wonderful features. However, every 6 months or so, youtube does something where the videos stop loading effectively killing the app. I usually switch between vanced and revanced every 6 or so months because one has so far always worked when the other gets the axe. By the time that one goes down, the other one is back up and running.
To be fair, I could say the same, but is probably a biased sample.
I have other red flags, like only distributing on docker, that I've tried, and tried again, and found that it's a sign of a badly run project. But I can't state any confidence on the discord based rule, because I've never tried to make any run.
The docker thing really grinds my gears. I see it as the ultimate "works on my machine" mentality. Basically they can't be arsed to write software that is robust to changes in hosting platform.
I have dealt with "only works in kubernetes" because developers couldn't be bothered to make it even work on docker without all the hidden orchestration.
So, instead of documentation, they just make the service work in that one specific environment.
The Gagguino project is a counterpoint to this. They have some extremely limited documentation, but to really build one you probably are going to need to dig into Discord. I hate it. The project is really cool, though, and I'm building one right now.