Hi Gabriele, thanks for this fast feedback. Actually we started with maven site but transferred our stuff to Confluence. The mvn site seems not to be very convenient for larger documentation work. Each typo fix needs a complete recompilation for seeing what you have written. You also need svn access for fixes. Confluence offers more comfort and better tooling imho. Personally I would appreciate if the barrier to provide useful documentation is not too high.
Are there any guidelines how Apache projects use these tools and what belongs where? Are there any plans how the others want to make use of it? Thanks Jens -----Original Message----- From: Gabriele Columbro [mailto:[email protected]] Sent: Freitag, 12. Februar 2010 09:48 To: [email protected] Subject: Re: Chemistry documentation page Hi Jens, I see the wiki actually as more developers/design documentation while I see the comprehensive and structured documentation as perfect fit for the Maven site capabilities. That would automatically generate a default documentation site (with selected reports) per every module + every custom documentation page you write in the src/site folder of that module. What do also the others think? Ciao! Gab On Feb 12, 2010, at 8:50 AM, Jens Hübel wrote: > Hi, > > > > we have started putting some documentation about OpenCMIS in the > Confluence wiki (http://cwiki.apache.org/CMIS/opencmis.html). With > the increasing community and the recent contributions the Chemistry > structure gets more complex. I think we need an overview page and > sub-sections for the sub projects. We also should provide a > description how the sub projects depend on each other or where they > are independent. > > > > Are there any proposals out there how to design the project > navigation? > > > > Jens > > > -- Eng. Gabriele Columbro Alfresco Software, Ltd. M: +31 (0)627 565 103 P: +39 320 161 28 46 D: +44 (0)1628 876 654 Skype: gabrielecolumbro Blog: http://www.mindthegab.com
