this post was submitted on 30 Sep 2023
181 points (88.5% liked)
Programmer Humor
32453 readers
597 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
Yeah, but the shittiness of a shitty community will come through in documentation that talks down to you and doesn't dain to explain things properly. And then when you go and ask a question because it wasn't well explained in the documentation and get derided for asking.
Fanboys are also likely to mislead (including in documentation) by downplaying caveats in libraries and such. Documentation can end up being more like marketing speak than technical reference.
You speak of "vocal minorities", but I don't think it's quite as simple as that. Languages have cultures around them. (As do lots of other things. Video games. Hardware devices. Car brands. What have you.) If a language has a toxic community around it, it might be an indication that the people behind the language may lack the ability or motivation to maintain a better community. Or worse, that they're doing things that promote or attract the shittiness.
So, in short, I disagree with you. For one thing "everything about this language is great except its community is shitty" makes me suspicious that maybe everything about the language isn't great and it has a really fanboyish community that likes to suppress any (even legitimate) negativity. Where I have to, I use the language I have to use, but when I have a choice, a shitty community is generally a deal breaker for me.
Rust documentation, at least for std is some of the best I have seen.
Gotcha. I can't really speak to the quality of any Rust official documentation.
Whats also nice is thst you put the documentation in the code and rust automatically generates a documentation page thsts hosted on docs.rs. So it makes really easy to have good docs for your stuff. If only everyone would document their stuff perfectly. A lot of the new released stuff gets released with minimal documentation.