I use Arch btw
Sister communities:
Community rules
Please report posts and comments that break these rules!
A discord server with absurd amounts of over emphasised text, making nothing stand out, filled with emojis and broken up into different messages and sections at the exactly worst places for legibility.
No messages are answered in any channel, and you get amazing sense of all of the technology we have to communicate but zero ability to use it.
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.
Speaks to the fact that we apparently need better and new alternatives or make current tools easier to use.
Certain aspects of discord seem to resonate with people (unfortunately...).
Man pages are great as mentioned, but maybe not as accessible to some people. Are there tools to generate more convenient resources (e.g. wikis) from that? Similar to how generating technical documentations from (structured) code 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.
And when the project is stable, they don't care to document it, either.
There seems to be some projects that allow indexing of discord. This should be encouraged more https://nextjs-forum.com/ is open sourced on GitHub.
Also stumbled on this the other day https://www.answeroverflow.com/
That’s only microsopically better than just discord. A (shitty, but somehow popular) chat service is not documentation, even if it’s indexed.