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

> "Poorly Documented Source Code Is Virtually Worthless".

And richly documented code is non-virtually worthless.

If you don't believe me, try parsing one of these so-called "literate programs." Any 10-year vet will far more quickly grok a piece of code when its textual flow isn't disrupted by verbiage that only makes sense to its author.



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

Search: