httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Daniel Gruno <rum...@cord.dk>
Subject Proposal to move docs to Apache CMS
Date Mon, 30 Apr 2012 15:36:29 GMT
Hi all,

Joe Schaefer has proposed that we move our documentation to the Apache
CMS(?) system (or at least try it out with a copy of trunk). From what I
have gathered with my discussion with Joe, this move would allow for
certain different ways of managing our documentation:

1) We can continue to commit XML files to SVN as we do now, but the
rebuilding could be managed by the CMS system, so we wouldn't have to
rebuild everything ourselves and then commit a heap of files for every
small edit we do. I am not aware of what would happen if someone commits
invalid XML though, but Joe should be on this mailing list, so if you
could, please do tell how that would be handled.

2) We can update/edit the XML files through an online XML editor
(presumably through cms.a.o?), and the resulting changes in the XHTML
will be automatically rebuilt by the server. This could ease up
situations where you have to make a minor modification, but don't have
all your SVN tools and repos at hand.

This would, no doubt, be a big change in the way we work, and it would
also require that we convert our existing documents to utf-8 format, but
I do see some clear advantages in this proposal, thus I'm sending it to
this list.

Any thoughts, ideas, comments?

With regards,
Daniel.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message