Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Many of us "autists" may be of the opinion that the code IS the documentation and describing that in ambiguous natural language for some unspecified audience is just not very useful (and can be actively harmful). Use the source luke.

The documentation discussion tends to take for granted that documentation is automatically valuable, and more documentation there is, the better. I find well named and structured code and actually executable standalone examples are far more valuable for understanding a codebase than some by-rote restating of what the code already says.



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

Search: