this post was submitted on 28 Jan 2024
2038 points (98.2% liked)
linuxmemes
21393 readers
1597 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
- 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
sudoin 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.
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
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.
There is a gazillion options without having to use a login walled proprietary solution.
It shouldn't be done at all. If you're updating discord, you're writing something. That something should be, at the bare minimum, in a README file.
If you can't be bothered with Markdown, just do text.
I've never encountered this in the wild so I can't say for certain why a FOSS project would choose to do this.
Maybe they are trying to get more people on their server?
Discord uses a subset of Markdown for message formatting, so they'll be writing it regardless
And when the project is stable, they don't care to document it, either.
The first doc you write is the FAQ and let it handle the common requests -- no need to 'live' in discord. Locating that where more people can see it is normally obvious.
Sounds like a project I don't want to use until it finishes baking.