This week's book giveaway is in the OO, Patterns, UML and Refactoring forum. We're giving away four copies of Refactoring for Software Design Smells: Managing Technical Debt and have Girish Suryanarayana, Ganesh Samarthyam & Tushar Sharma on-line! See this thread for details.
You may want to look at SCJD Study Companion I expect I'll be starting on documentation in another day or two (like anybody really documents as they go along...), but the above furnished me with templates named DesignChoices.html, HandBook.html, and UserDoc.html (there's no requirement to do the docs in HTML of course). My intention is to put little more into readme.txt than "see DesignChoices.html," etc. The names of the documents themselves should indicate what they contain- and where you should put a given bit of documentation.
Fly by Night Consultants<br /> <blockquote><font size="1" face="Verdana, Arial">quote:</font><hr><i>I climbed on the back of a giant albatross<br />which flew through a crack in the cloud<br />to a place where happiness reigned...<br />all year 'round<br />the music played ever so loudly!</i><p><a href="http://thomasfly.com/songs/Traffic/Hole_in_my_Shoe_qt.htm" target="_blank" rel="nofollow">Hole in My Shoe</a><hr></blockquote>