On Jul 7, 2009, at 7:20 PM, Nicholas L Gallardo wrote:
I agree with Jason's point below that the ability to edit the docs
should be generally accessible. Jason, can you think of any examples
of PDFs that have been generated from cwiki content? I'd be curious
to see how much it resembles the wiki itself.
Off hand, no, but I can generate one for you if you like from
something in the GMOx* spaces. It does a good job, but has some warts.
Eli made good points earlier too about not wanting to have a single
page that became the doc. It needs to be a well-organized tree that
can then have a PDF generated from there. Don't know if that's
possible though.
In Confluence-lang a section of a PDF tends to become its own page,
sub-sections could be their own-page depending on complexity and
size. Chapters would be their own page, blah, blah, blah.
You could even have a single page, which includes all of the other
pages if you really wanted that huge massive single-page doc.
Another point to consider. For the online docs, it would be nice to
keep them versioned under link that correspond to the release
(separate docs for 0.1, 0.2, 1.0, etc.)
Geronimo handles with with a GMOxDOC<VERSION> space. You can see them
all here:
http://cwiki.apache.org/confluence/dashboard.action
Just search for GMOx and see all the spaces that Geronimo has.
* * *
I would recommend limiting the number of spaces for now to two... one
for the site, one for the docs until incubation has finished, I don't
think infra would have a problem with that.
--jason
PS. exporting the GMOxDOC21 space now as PDF... hope it doesn't crash
Confluence ;-)
