[Bf-docboard] Re: Let's start again...

[Martin Kleppmann]

On Mar 16 2004, Stefano Selleri wrote:
> > What writing tools do you use? I can contribute in this area - 
> > FrameMaker, Word, InDesign, Illustrator, Photoshop, Acrobat, plus have 
> > expert skill with WebWorks Publisher for conversions.
> 
> This is the real key issue.
> Up to now EMACS was used, and this is not exactly user friendly.

I think we should really stick to XML-DocBook. It does have the 
disadvantage that new contributors will have to learn it first - but would 
vastly increase the amount of work if we abandoned XML since CVS wouldn't 
work as effectively.

We could consider exporting DocBook to some format understood by one of 
these word/layout processing packages once in a while, and creating a 
beautiful layout, but our priority should probably be to keep the docs 
up-to-date, not pretty.

If we extend the introduction given to XML, DocBook & CVS in the appendix 
of the manual, it should be no problem for new users to get the hang of it. 
And there are also various free XML editors around that would make things 
easier.

Martin

-- 
+++ martin kleppmann +++ http://www.kleppmann.de +++