where everyone thinks the useful info should be:

- README file
- the manual
- official wiki

where it usually is instead:

- StackOverflow
- GitHub
- Reddit

people hate "making documentation" but they love asking and answering questions.

so maybe have documentation that can be created by having people do that?

@thor My experience with documentation for open source projects is that people get overly pedantic about wording, rather than having something there. Even small changes can take time to get merged.

Mastodon's documentation repo is a prime example.

Follow

@nikdoof The opposite approach can be harmful as well, there are a lot of insightful answers on StackOverflow, but bad ones are not uncommon. People often share half-baked solutions that worked for them without understanding underlying principles. One such case was covered on Slashdot — a certain answer about .Net or C# that worked, but caused issues later on lived there for years and even made it into commercial software, Razer Synapse if memory serves me.
@thor

Sign in to participate in the conversation
Librem Social

Librem Social is an opt-in public network. Messages are shared under Creative Commons BY-SA 4.0 license terms. Policy.

Stay safe. Please abide by our code of conduct.

(Source code)

image/svg+xml Librem Chat image/svg+xml