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

Martin Kleppmann bf-docboard@blender.org
22 Mar 2004 10:04:27 +0000


Strange! Did you also only just get this email? I sent it about 5 days ago, 
so it is obviously quite irrelevant to the discussion now. Very sorry.

But why did it take so long? I've never seen an email so slow before. Well, 
I hope this one is faster.

Sorry about that
Martin


On Mar 22 2004, Martin Kleppmann wrote:
> 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 +++