Not sure if everyone here knows the difference between documentation and discussion.
Name and shame!
This was/is my main gripe with Beyond All Reason (open source rts game) there is no wiki or forums - for an outsider it looks like 98% of all development talk is done in discord.
Though they do have a good basic knowledge base on their website about the game units and mechanics (but I would love dedicated wiki).
I once dm’d the maintainer of an open source project who got kind of upset at me for not posting an issue in GitHub. I got it, it made sense and the guy explained that it was all about visibility.
How to install:
Step 1: git clone website
Step 2: run dependency install script
Step 2 again: Ha, ha, just kidding, that would be to straight forward. Please install this dependency installer program that only this and two other projects use. Pip grep panda cholotte poetry bash docker numpty anaconda jupternotebook alacazam. Oh, you don't have it? Well, I'm sure the project page will tell you how to install it and add it to path!
Step 3: Run " program name" and .... "insanely detailed description of what to do once the program opens"
Step 3 again: When you run it, get error "k*args passed null into program, so eat shit you can't fix this"
Step 4: Go to git hub issue page and see people have been complaining about this error for 6 months, but it was working back then when it's 12 dependency hadn't been updated yet. No fix incoming since the programmer was a chineese grad student that graduated 6 months ago and stopped working on the code.
If it's not search indexable it can go eat dirt
Fork it, clean it up, post it in their discord.
This is often done by people while the project is unstable. No need to write documentation that gets outdated every few weeks, when you can help people live in discord.
And when the project is stable, they don't care to document it, either.
Not the dascord!!
Not the Dwildcardscord!!!
linuxmemes
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
- Understand the difference between a joke and an insult.
- Do not harrass or attack members of the community for any reason.
- Leave remarks of "peasantry" to the PCMR community. If you dislike an OS/service/application, attack the thing you dislike, not the individuals who use it. Some people may not have a choice.
- Bigotry will not be tolerated.
- These rules are somewhat loosened when the subject is a public figure. Still, do not attack their person or incite harrassment.
3. Post Linux-related content
- Including Unix and BSD.
- Non-Linux content is acceptable as long as it makes a reference to Linux. For example, the poorly made mockery of
sudo
in Windows. - No porn. Even if you watch it on a Linux machine.
4. No recent reposts
- Everybody uses Arch btw, can't quit Vim, and wants to interject for a moment. You can stop now.
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 fork-bomb your computer.