Mostly everyone I talk to says they don't like to write documentation. Why is that?<p>What ultimately forces your hand and compels you to document things?<p>What are examples of great documentation (i.e. easy to write and/or consume) that you've seen?
> Mostly everyone I talk to says they don't like to write documentation. Why is that?<p>I hate writing documentation. You know what I hate even more? Having to <i>talk</i> to people. I got into this trade so I wouldn't <i>have</i> to talk to people, dammit.
Needing to understand my code in six months time. Making it easier for others to maintain my code. Making it easier for others to install my code. Making it easier for others to use my code.<p>If you or anybody else doesn't use your code after it's written, don't document it.
As a solo developer of HashBackup, good documentation allows me to work on what I enjoy - coding - rather than answering tech support questions caused by inadequate documentation. I actually enjoy writing documentation now, since it enables people to take full advantage of the software all on their own.