[Gardeners] texinfo/documentation

[JC Helary]

On 2006/01/06, at 14:40, Tim Cross wrote:
> In reality, it would be good if documentation was in an even more
> 'generic' form, like docbook or sgml so that there is more flexibility
> in final format choices. However, decent authoring environments for
> working with such formats as docbook are expensive or, in the case of
> free and open source, still quite limited/slow to work with.
>
> I guess the main thing is that the format used is less important than
> consistency - though there is the open question regarding whether the
> use of texinfo as the 'official' documentation for a project actually
> results in less useful documentation than would occur with a more
> widely known markup language.

It would be nice if the source format was an easily translatable  
format: are there xliff convertors for it ? for example.

.po based conversion are ok, but localisation standards have greatly  
evolved in the last few years and opensource tools are following very  
close.

Docbook-xml would seem like a good choice.

JC Helary