Hacker News new | ask | show | jobs
by geofft 2012 days ago
I hope the software industry realizes that good documentation is more valuable than good code. Code is transient, and even good code today will be called techdebt tomorrow when the next language or framework or library shows up. But bad documentation impedes your ability to write good code, your ability to work with other parts of the organization, and your ability to grow your business by having outsiders integate with you (as in this case): it also has the effect of turning code into techdebt, by causing people to write new implementations of code they otherwise could have used, because they have no documentation for it.

One step we could take is in hiring. When interviewing developers, let's ask them to write documentation, not just code.

1 comments

It’s worth fuck all because sellers will bang their head on a wall for 2 months until they work it out because they have no other option.