httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: Proposal to move docs to Apache CMS
Date Mon, 30 Apr 2012 15:46:40 GMT

On Apr 30, 2012, at 11:36 AM, Daniel Gruno wrote:

> 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?


Thanks for heading this up. I talked with Joe about this years ago, but then never followed
up on it.

My biggest question is whether it would require that we rewrite our XML, or if the existing
XML is already in the right DTD?

--
Rich Bowen
rbowen@rcbowen.com :: @rbowen
rbowen@apache.org







Mime
View raw message