Hacker News new | past | comments | ask | show | jobs | submit login

TL;DR: The people may be stupid, or may do a messy work, therefore it must be the methods they use or the requirements that are faulty in the first place.



Better TL;DR: Would you rather have 10% of functions commented or 90%? Author argues that 10% is better, if all functions are documented then documentation is obvious, noise, and often wrong. Document the non-obvious cases.


Would you rather go to one extreme or to the other one?

Please downvote me again.




Join us for AI Startup School this June 16-17 in San Francisco!

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: