How to Write Software Documentation. Good software documentation, whether a specifications document for programmers and testers, a technical document for. I love Django's documentation. It clocks in at about pages printed, and most of it is clear, concise, and helpful. I think Django's among the best documented. Patience and empathy are the basis of good documentation, much as they documentation —is the only way for people to use your software. What can be applied to open source? The same applies for blog posts except for the points. So I write free books just trying to get outsiders in the door, all the way warning them it's not a nice place but you can sure get a lot of work. Hadzijo on 12 Jul Permalink. You release code, and the code gnomes come and make it better for you. Helped me quite alot.