V2 documentation format: a resolution?

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-02-03 03:07:05

There were quite a lot of responses about V2 documentation format. The one 
thing everybody agreed, is that Zbynek's version of current docs looks very 
nice.

As for format, Christopher said that DocBook conversion should not be very 
hard. So, DocBook and ReST are the alternatives now.

While I agree and ReST source is much nicer, I'd still rather stuck with the 
most widespread solution. I know that DocBook is used by lots. Examples, such 
as 

http://svnbook.red-bean.com/html-chunk/
http://scarab-gen.tigris.org/scarab-admin/

look quite reasonable and PDF output looks reasonable, too. As for ReST, I'm 
concerned that it might have limitations we're not aware of now.

So, let's go with DocBook?

Christopher, you had volunteered to convert docs to DocBook while retaining 
look of Zbynek's version. I'd very much appreciate if you do that! 

Thanks,
Volodya