1085
Discord != Documentation
(lemmy.dbzer0.com)
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 28 Jul 2023
1085 points (100.0% liked)
Programmer Humor
32753 readers
62 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
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??
Us the 90s kids grew up with the idea of 'internet as a library', which means websites are treated as books or magazines inside the shelves, that serve as repositories. We still have to read, but we were also used to it.
Perhaps it's a generational shift, but nowadays 'internet as an assistant' approach is gaining over, which means the search bar (whichever it happens to be from) is treated as a search engine, and user directly inputs a semantic question expecting it to be answered. Users don't expect to read, and aren't expected to. Advertisement space is far more important.
When you think of that way, the idea of having a chatroom instead of proper support forum start making sense, even if I dread this idea and prefer proper text.
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