I plainly : - produce "good" javadoc of the few java classes I create, - comment my sitemap and xsl while developping them, - produce a text (Word) document explaining more in detail pipelines' and xsl' roles... and also some notes about the Cocoon components I used (what they are for), and since I did not use every component available...
But I am not creating a new system, just redesigning an old one. So my documents contain some info on Cocoon and much on what I developped. IMHO, you might think project documenting needs 15% of project developping time, and better a lot of comments in the code to be reordered afterwards. Babs ----- Original Message ----- From: <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Wednesday, October 09, 2002 4:33 PM Subject: how do you document your projects? > Hi, > > i am just wondering: if and how do you document your cocoon projects? I > don´t mean cocoon itself, but the projects you build up on cocoon. > > For the moment i am working on my own, but i think if i should give the > results in someoneelse´s hand, noone could easily understand what i did and > why i did it. Also when developing in a team, a project documentation would > be useful. (Besides that i sometimes loose my own structure ;) > > Are there any thougths about how to structure a cocoon project > documentation? Is there maybe a graphical notation on what happens inside > cocoon? E. g. which context is mapped where to and what kind of generators, > transformators etc. are applied? Any tools you can recommend? > > best regards > Jörn > > > --------------------------------------------------------------------- > Please check that your question has not already been answered in the > FAQ before posting. <http://xml.apache.org/cocoon/faq/index.html> > > To unsubscribe, e-mail: <[EMAIL PROTECTED]> > For additional commands, e-mail: <[EMAIL PROTECTED]> > > ______________________________________________________________________ > Etudiant: Wanadoo t'offre le Pack eXtense Haut Débit soit 150,92 euros > d'économies ! Clique ici : http://www.ifrance.com/_reloc/mail.etudiant --------------------------------------------------------------------- Please check that your question has not already been answered in the FAQ before posting. <http://xml.apache.org/cocoon/faq/index.html> To unsubscribe, e-mail: <[EMAIL PROTECTED]> For additional commands, e-mail: <[EMAIL PROTECTED]>
