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

> Humans know exactly what parts went into it and how it works. Why must wisdom always be squeezed out of a rock?

Partly, because so many developers famously hate writing documentation and hate commenting their code.

If developers followed Donald Knuth's Literate Programming [1] then it would be a big improvement.

People rely on a lot of "tribal knowledge" without ever bothering to write it down, and out of all the fields, software development seems to be particularly notorious for its anti-documentation bias.

[1] https://en.wikipedia.org/wiki/Literate_programming



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

Search: