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

List:       kde-i18n-doc
Subject:    Re: [kde-doc-english]Re: documentation size
From:       Eric Bischoff <e.bischoff () noos ! fr>
Date:       2001-05-29 8:11:53
[Download RAW message or body]

Le Lundi 28 Mai 2001 17:18, Lauri Watts a écrit :
> > Le Samedi 26 Mai 2001 23:29, Tamas Szanto a écrit :
>
> > > khelpcenter_faq - 136 KB
> > > kppp - 146 KB
> > > knode - 169 KB
> > > kword - 256 KB
> > > artsbuilder - 267 KB
> > >
> > > Well, it seems to me that in most cases (for smaller apps) 50 KB is
> > > sufficient for the documentation, and I think that some of these files
> > > are simply unjustifiably big. I know that the current policy is to keep
> > > the technical and end-user part of the documentation together
>
> Seems I can't win.  We have constant complaints from users that what they
> want to know is not covered in the documentation, and asking for more, on
> other topics.  We are lambasted all over slashdot and dot for not providing
> enough documentation pitched at the beginners.

My two eurocents: what is important is what the end user asks for, not what 
we find convenient to translate. However, perharps the solution could be to 
have different handbooks for end-user and technical parts, thus allowing to 
translate at least a minimal part. I don't know if this idea makes sense, 
Lauri?

> There are over a hundred
> applications/daemons with no documentation at all (and don't think I don't
> get complaints about that too) but these *will* have documentation
> eventally, and some of them will be large. I have Krayon's manual nearly
> ready to go into CVS right now.   It's 93 kb unedited, and not near
> complete or comprehensive, so get used to the idea.
>
> How ironic, I just the other day saw a developer saying on another mailing
> list that he considered only knode and kppp actually *had* comprehensive
> and "professional" documentation.  I disagree to an extent, because I think
> there are a few other apps that are very complete and well documented, but
> the point is, I don't get regular emails agreeing with you and asking that
> the documentation be reduced.
>
> So here it is: I refuse point blank to limit documentation based on file
> size. (...)

-- 
Éric Bischoff  -  Documentation and Localization
Caldera (Deutschland) GmbH - Linux for eBusiness
Tel: +49 9131 7192 300 -  Fax: +49 9131 7192 399
http://www.caldera.de/

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