I do a lot of FOSS work. I dont write docs for everyone most of the timr. I write docs for those already educated on most of the items. This still applies, and is accessible to anyone:

If you don't know the word, look it up in the dictionary.

I don't want to downplay frustrations, I know those are real, but most people writing these things aren't paid.

Note: If a Dev complains their idea isn't adopted and the docs suck, that's another story.

Edit: And the article seems to be by a career writer, so it makes sense from their perspective, but some more expansive thinking on their part about how a developer isn't staffed to do their job, too, would be helpful.

[–] CheerfulPassionFruit@lemmy.world 11 points 1 month ago (1 children)

Docs aren't for everybody sometimes stuff is just complex and requires prior understanding. I guess that's where more people can help FOSS projects, by writing more accessible docs and pre packaging stuff so it can be used by less technical people or someone who's just starting out.

[–] fmstrat@lemmy.nowsci.com 2 points 1 month ago

Agreed, maybe this writer could step in and volunteer their time instead of writing satire complaining about it.

load more comments (24 replies)