cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Barbara Post" <bab...@ifrance.com>
Subject Re: how do you document your projects?
Date Wed, 09 Oct 2002 16:05:52 GMT
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: <Joern_Hoos@notes.uni-paderborn.de>
To: <cocoon-users@xml.apache.org>
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:     <cocoon-users-unsubscribe@xml.apache.org>
> For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>
>
> ______________________________________________________________________
> 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:     <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>


Mime
View raw message