Hacker News new | ask | show | jobs
by CriticalCathed 2491 days ago
If it's that important and complex, have an accompanying README that lists line numbers and comments.
2 comments

Good idea! And then put a comment into the configuration file that refers to where the documentation is.. ah, f__k!
Lesson to learn: Nobody reads the docs.
This is such a dumb aphorism. I read and create docs every single day.

If the comments are so critical that it is a problem, then an accompanying file with those comments would be used. Otherwise, it's just a bunch of crocodile tears.