Hi,
Am 27.03.2013 07:23, schrieb Maruan Sahyoun:
thx for the offer to help. I think it's needed :-)
I'm happy that someone is eager enough to do some of the not so cool things
like documentation. ;-)
I already read about the Apache CMS and svnpubsub and think that the CMS is
> the way to go although it's initially a little more effort. One of the major
> benefits of the CMS is that non technical users can use it (the web UI) and
> it's easier for non comitters to contribute [1].
+1, nothing to add here
As soon as I get a go to move forward I'll open a ticket on Jira to track the
> status of the move. The initial step will be to get myself familiar with the
> tools to build the site as described in [2].
It looks like people gathered a lot of CMS related information so that you
should find everything you need. If some piece is missing try to ask for it
on one of the mentioned mailing lists.
Maybe some of the steps will need PMC-chair power (I saw a form to request the
svn space for the CMS which is limited to chairs) so that I've to step in.
IMHO the following steps have to be done (this list is not exhaustive)
- migrate the existing xdoc files to markdown (maybe there is a script doing
that?)
- create a new content structure following the CMS needs (there is a minimal
example on the cms-wiki-page)
- get in touch with infra to request all the needed things to do the transition
(AFAIU several steps are needed)
> I propose the migration to reuse
> the current content and most of the current navigation and optimize at a later
> stage but making a clearer distinction between users of and developers for
pdfbox.
I'm not sure which way is the best, but I'm sure you'll find out. :-)
Maruan Sahyoun
[1] http://www.apache.org/dev/cmsref.html#non-committer
[2] http://www.apache.org/dev/cmsref.html
BR
Andreas Lehmkühler
