Imagine being in a corporate environment trying to implement an OSS into your platform and having to tell your 50 yo teammate: "Oh yeah, just pop in this Discord server real quick to see any relevant info". Instant credibility loss
Programmer Humor
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.
The loss of credibility is not because it's discord,. specifically.
It's because the project thinks a chat platform is an appropriate way to document a project. I would feel the same way if someone told me to get on IRC for docs, or Slack.
D🤮scord
I've literally never seen a project remotely interesting that has their documentation on discord
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.
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.
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.
I am already happy if there is any documentation at all. And I am euphoric if it doesn't suck, i.e. sufficiently detailed and up to date.
So I guess Discord is better than nothing. But sure it's a turn off.
Log into discord, copy the documentation and create a PR with it. (Or make a wiki?)
You old farts should keep up with times. /s
Preach!