Hacker News new | ask | show | jobs
by JohnFen 641 days ago
> There's a statement that good code is self-explanatory

Yeah, and that's a statement that has never been true except in trivial cases. Comments and documentation tell the "why", and comments provide additional clarity. Good code tells the "what".

The reason I document boils down to the old saw: be kind to the developer who has to touch the code in the future, particularly because that developer will probably be you.