Re: documentation questions

From: J.M. Maurer <j.m.maurer_at_student.utwente.nl>
Date: Sun Jan 16 2005 - 02:50:09 CET

On Sat, 2005-01-15 at 21:08 +0100, Reinout van Schouwen wrote:
> On Sat, 15 Jan 2005 04:08:05 +0100, J.M. Maurer
> <j.m.maurer@student.utwente.nl> wrote:
>
> > In the future, we also need a good framework to translate the
> > documentation. Maybe something along the lines of .po files. We can
> > worry about this later though. We first need good and complete english
> > documentation as a base.
>
> It would be backwards to start a documentation overhaul and not take
> documentation translation into account, instead deferring it to "the
> future". Almost all free software I know of has documentation in
> DocBook XML, which can be transformed to lots of other formats if
> required. The 'xml2po' scripts are in a usable state and are already
> used by some projects to translate documentation. Currently I'd advise
> to go that route.

Not an overhaul, but extending it. Currently, the documentation is in
AbiWord format. You can move it to DocBook XML now, or in the future. It
doesn't really matter *when* you are moving it.

I would be great if someone would be willing to move it to DocBook XML
now, but that would depend solely on the effort people are willing to
make. If 'they' want to do it, then that would be great. If they just
want to extend the current documentation in abw format, then that is
great too.

Marc
Received on Sun Jan 16 02:50:05 2005

This archive was generated by hypermail 2.1.8 : Sun Jan 16 2005 - 02:50:05 CET