Reinhard Poetz wrote:
At http://wiki.apache.org/cocoon/CocoonDocumentationSystem I propose the architecture of a new extensible documentation system.
Thanks, a brilliant step.
My first goal is reusing existing functionality (SVN, Forrest, static web pages). Writing the missing pieces (a small web application to edit docs online) shouldn't be too difficult - especially using CocoonForms (HTMLArea with HTMLCleaning convertor are shining here!) and Flowscript.
At the end of the document you find a roadmap. It also contains some parts where I *really* need some help by others:
- component (Java) that reads from and commits to SVN - should work over WebDAV, shouldn't it? I know there are some specialist in this community who could help out here (Unico, Gianugo, Guido)
We have a huge team of specialists on the dev list.
Yep. I hope that I can convince at least one of them to help me. Actually I need some Java code ;-) So here I ask officially: Who volunteers to write the Java code that communicates with the SVN repository (read and commit)?
- enable the publishing process (forrestbot or cron)
Unfortunatly I don't have any experience with setting up this publishing process. David, do you know who I can ping to get help here?
Both.
At forrest-dev we are also starting to set up a demo of the new forrestbot and its webapp interface. So yes, we will be able to help on some aspects.
The "Proposal for ASF-wide documentation staging and publishing" intends to enable various document management systems to feed into staging areas. I will add a para to the wiki page.
Can you give me a pointer to this document?
- SSL setup
I don't think that a technical solution will directly lead to better docs. I just think that making the doc authoring process much easier will invite much more people to help out.
WDYT?
WDYR = What Do You Reckon we think? ... excellent, of course.
:-)
-- Reinhard
