Re: handbook: cvs or wiki?

[Sascha Wildner <saw@xxxxxxxxx>]

justin@xxxxxxxxxxxxxxxxxx wrote:

> There is no set way to convert between the handbook in CVS and the version
> in the wiki.  I wish there was...  I know that it's generally possible to
> get MediaWiki (which was, last I saw, what was being used for the wiki) to
> output XML, and the handbook should probably be moved from to xml, but
> it's a task nobody's been able to tackle yet.  I'd love to, and I may if I
> get time again in the future.  (recently changed jobs and house)

Last time I looked the Wiki's XML export function was unusable (XML 
markup was provided for stuff like the page name but not for the 
structure of the text itself, which was output in a big block). Feel 
free to try it.


> I would be happy to ditch the cvs version if it was possible to produce
> what it does through the wiki, just because it seems to add a higher
> barrier to contributions than it should.
>
> All that aside - If you want to produce changes for the cvs version that
> correct for the FreeBSDisms that I've missed, please do!  I'd be happy to
> go through them/commit them.

We already have a number of handbook changes in the Wiki and IMHO it 
would be more difficult to get changes made to the docbook handbook in 
to the Wiki than vice versa. So I propose Jeremy make his changes in the 
Wiki. I could look at bringing them into CVS next weekend.

The Wiki's diff function is also much better for updating the CVS than 
going through the commit messages and syncing stuff back into the Wiki.

Just my €0.02. But I'd really like to hear other people's opinions on this.

Sascha

--
http://yoyodyne.ath.cx