this post was submitted on 28 Jul 2023
1086 points (99.0% liked)
Programmer Humor
32380 readers
1435 users here now
Post funny things about programming here! (Or just rant about your favourite programming language.)
Rules:
- Posts must be relevant to programming, programmers, or computer science.
- No NSFW content.
- Jokes must be in good taste. No hate speech, bigotry, etc.
founded 5 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
So much yesss, that drives me nuts, regardless of age!
I know that it's just hip and familiar to many, so I put with it with the few projects I'm really interested in and I can't say it doesn't work well, but please, why are there SO MANY??
That's a very interesting observation, I have to admit that even I sometimes am too lazy to read documentation from top to bottom and prefer asking a question to someone that already knows. Though I think it can also be attributed to how good a certain text is structured, quality of documentation should account not only for completeness, but also for laying out the information to be easy to parse and highlight the most important parts, which is maybe why I feel "documentation fatigue" in some cases
For open source, I almost always found IRC was a black hole of information. All kinds of developers discussing things that never made it to search engines. It's a long tradition.
As a dev, far easier to answer questions about my code than write up documentation, so makes total sense to me
With discord at least you can usually search chat history for your question and find someone else asking it in the past
I wonder... Might be able to write a language model based crawler that goes through a discord server and pulls out all the useful information to generate documentation or at least a FAQ