2035
Never again
(lemmy.world)
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 28 Jan 2024
2035 points (98.3% liked)
linuxmemes
24209 readers
584 users here now
Hint: :q!
Sister communities:
Community rules (click to expand)
1. Follow the site-wide rules
- Instance-wide TOS: https://legal.lemmy.world/tos/
- Lemmy code of conduct: https://join-lemmy.org/docs/code_of_conduct.html
2. Be civil
3. Post Linux-related content
sudo in Windows.4. No recent reposts
5. π¬π§ Language/ΡΠ·ΡΠΊ/Sprache
6. (NEW!) Regarding public figures
We all have our opinions, and certain public figures can be divisive. Keep in mind that this is a community for memes and light-hearted fun, not for airing grievances or leveling accusations.Please report posts and comments that break these rules!
Important: never execute code or follow advice that you don't understand or can't verify, especially here. The word of the day is credibility. This is a meme community -- even the most helpful comments might just be shitposts that can damage your system. Be aware, be smart, don't remove France.
founded 2 years ago
MODERATORS
Firstly, discord is entirely the wrong medium for documentation.
Secondly, documentation should be at least as accessible as the code. That is to say, if I can view the code without creating an account for some service, then I should also be able to read the documentation too.
Documentation is bad enough. But it's worse when that's the only channel to get support. I once read a project maintainer boast that they never read the bug reports and issues on github and if anyone had a bug to just chat him up discord. I mean, dude, no wonder nobody uses your software or takes it seriously. Much less want to collaborate on the development.
I can't understand why someone would want to do that. Maybe it's my help desk and IT upbringing, but for the few software tools and things I've made, if you chat me without filing a bug/issue on GitHub, I'm not gonna help you.
You can open an issue and say exactly that
Yep, and if it becomes a frequent request, add clarification to the readme / wiki / documentation.
Also, if you push folks towards issues, then they become indexable by search engines! So even if you have a solved problem you can at least find that... Discord? It's a black hole.
And then get it insta-closed withing 20 minutes saying that "this is a problem with your setup, not the software" even when "my setup" was literally setting up their project using their documentation (docker compose files).
That is how developers treat people with questions that they deem "stupid."
It turns out their documentation was wrong and some environment variable that they said was optional, was not actually optional and the service would go into a reboot loop without it. I figured that out no thanks to the devs.
Update your issue with a pull request fixing the documentation. When you're doing things on github, 99.999% of your audience is the general public, not the maintainer, because they will find your issue and solution through search engines.
Agreed. I may not want to mix my discord identity with whatever project I'm looking at. I especially don't want to mix my personal online identity with my professional identity. I post too much politics for that.