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

List:       kde-i18n-doc
Subject:    Re: obsolete docs
From:       Lauri Watts <lauri () kde ! org>
Date:       2004-01-26 23:44:22
Message-ID: 200401270044.26451.lauri () kde ! org
[Download RAW message or body]


On Tuesday 27 January 2004 00.04, Gérard Delafond wrote:
> Hi
>
> I am working on the translation of some documentation.
>
> It appears that many of them are out of date.
>
> The described functions or the screenshots do not match to the GUIs in many
> cases.
>
> The question is What is the best way to get some "clean" documentations ?

Recruit more people.  There's only so much documentation Phil and I can manage 
on our own, and you're seeing the result.   

Report them as bugs, we *are* going through the bugs and fixing things, and 
yes, translators make great bug reporters.  An actual list of 'things that 
need fixing' saves a lot of time.

There's a pre KDE 3.2 list at http://people.fruitsalad.org/lauri/docs/ - much 
of what's on there, Phil has now filed as bugs, and we intend to use Bugzilla 
in future to help with tracking what needs doing.

> I think the best should be developers send an information to the docs
> writers when new functions appear.

Best of luck making that happen.  All they have to do is put a GUI: in their 
cvs commit logs, and I will get a separate copy of the mail to forward to the 
(largely nonexistent) document maintainers. 

> Is there somebody or a team to check the consistency of all the
> documentations ?

What there is of a team, is on the kde-doc-english@ mailing list, not this 
one.  Bug reports also show up there.    Phil and I went through literally a 
couple of hundred documents each pre KDE 3.2, and cleaned up a whole lot of 
things, and this is an ongoing process.

Right now, bugzilla reports are the best thing you can do currently.  It's 
helpful if you file bugs on a per doc basis (makes it easier to keep track of 
as we work on fixing them.)

Regards,
-- 
Lauri Watts
KDE Documentation: http://i18n.kde.org/doc/
KDE on FreeBSD: http://freebsd.kde.org/

[Attachment #3 (application/pgp-signature)]

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