I am building a "context" that Cocoon 2 would use to create the
documentation for our site. This encapsulates all doc building
info which includes:
* Cocoon configuration (cocoon.xconf, sitemap.xmap, & web.xml)
* Stylesheets
* Resources
* xdocs
I would like to name the directory "documentation". This would
change the $jakarta-avalon/src directory structure to this:
$jakarta-avalon/src/
java/
scratchpad/
test/
documentation/
stylesheets/
resources/
images/
history/images/
developing/images/
xdocs/
developing/
history/
framework/
excalibur/
sitemap.xmap
WEB-INF/
cocoon.xconf
web.xml
As you can see, all documentation related information is kept
in its own container. Until we are done converting all our
documentation to DocBook, I will have a rudimentary stylesheet
that will convert our existing docs to DocBook (there still
will be a few tweaks needed, but it is quick and dirty).
Also, once I check in the documentation directory, there will
be an "authors" directory. I would appreciate everyone placing
their bio in the same format as is in "bloritsch.xml" and updating
the book.xml file to list your bio in the list of authors.
The naming convention for the author bios I chose is that the
name should match the first part of your apache.org email address
([EMAIL PROTECTED] = bloritsch.xml). It also lends some
credentials to our project.
This is going to rock!
S/MIME Cryptographic Signature
