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

Documentation describing whats already their and why, or documentation describing what's suppose to be there and why? Or both?


Both, in my opinion. From incipient need (rfc, etc) to use-cases, to design specifications, tolerance acceptances, expectation management, support, and finally sunset/archival.

If the code is where the “why” is found, those who are the end goal consumers of the product will be frustrated, for a small example.




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

Search: