this post was submitted on 07 Jun 2025
605 points (95.4% liked)
Programmer Humor
23919 readers
1080 users here now
Welcome to Programmer Humor!
This is a place where you can post jokes, memes, humor, etc. related to programming!
For sharing awful code theres also Programming Horror.
Rules
- Keep content in english
- No advertisements
- Posts must be related to programming or programmer topics
founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Absolutely not. I'd rather have no documentation and start from scratch than be gaslit by an entire team of people telling me that the very obviously wrong documentation is correct and has been correct for 30 years
I think there's a difference between bad and wrong. Wrong documentation is incorrect. Bad documentation isn't really incorrect, it's just poorly executedb and mostly unhelpful.
I mean, incorrect documentation is clearly bad, so...
Seemed more like the problem was the gaslighting than the documentation.
Wrong documentation is still a pretty big problem, even without the gaslighting. Incomplete documentation is better than none; incorrect documentation is not.