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

Technical documents don't have to be readable, they have to be comprehensible (and preferably quite comprehensive too).


They have to be readable enough for the reader to be able to recreate what's described from those documents, and you can only test for that by... trying to use the documents to recreate the work. Which is rarely attempted, especially in large, expensive projects.

(It's the same thing as the "you only have a backup if you actually restored it at least once" adage.)




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

Search: