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 rbo...@rcbowen.com :: @rbowen rbo...@apache.org
