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

I think it’s the same problem as trying to document how to install or use new software. Unless you redo the steps yourself or somebody does that for you, you won’t know which assumptions you forgot to document. Since no-one retries the study right after you finished it, there out to be gaps in the documentation.


Yes. "If it ain't tested, it is broken" applies just as much to documentation.

This is why everything should have CI, and one should ask at least one person to set up the system from scratch using just the documentation.




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

Search: