[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-doc
Subject:    Re: Autogenerating docbooks
From:       Albert Astals Cid <aacid () kde ! org>
Date:       2010-02-24 8:40:24
Message-ID: 201002240840.25398.aacid () kde ! org
[Download RAW message or body]

A Dimecres, 24 de febrer de 2010, Martin Schlander va escriure:
> Tirsdag den 23. februar 2010 22:44:27 skrev Albert Astals Cid:
> > Hi, seems we are having some problems with docbooks lately:
> >  * Some people do not know how to properly generate docbooks
> >  * Some teams have lots of obsolete docbooks
> >  * Sometimes it's difficult to have uptodate kdelibs to generate the
> >  docbooks * Non compiling docbooks are more common that i would want
> > 
> > So now that we are probably going to get a new l10n.kde.org server i'd
> > want
> > 
> >  to propose that we do the docbook generation on the server side together
> >  with the script that generates the docbooks i'd like to introduce one
> >  that deletes docbooks so that we do not end with bitrotting. The rule
> >  i've been thinking for deleting docbooks is "A docbook is deleted if it
> >  has not been able to be generated from .po files correctly for four
> >  months".
> > 
> > Comments?
> 
> How would we know if the docbooks generate correctly or not. Would there be
> something like the xml-error pages that we can keep track of?

That's the idea, yes.

> 
> Does this suggestion solve the issue of outdated docbooks? 

It does as it deletes docbooks that have not been able to generate for four 
months

> Will not fully translated POs lead to the docbook not being able to 
generate?

Yes, and once they fail to generate for four months the docbook will be 
deleted and not outdated anymore.

Albert
[prev in list] [next in list] [prev in thread] [next in thread]