Hacker News new | past | comments | ask | show | jobs | submit login

How about this: most code has hard chunks or even sections that can be nearly impossible to figure out without a significant time investment. We can skip the intermediate steps and just move straight to a document that explains the architecture so that we may stop trying to jump through hoops to avoid writing non-comment documentation.

The amount of places I’ve worked at that don’t even have accessible DB schemas is mind-boggling.




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

Search: