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

List:       kde-devel
Subject:    Re: online API Reference
From:       "V. Alex Brennen" <vab () cryptnet ! net>
Date:       2001-01-08 3:53:24
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Sun, 7 Jan 2001, Malte Starostik wrote:

> > > "This section contains the KDE 2.0 online class reference. Note that the
> > > KDE 2.0 API is not yet finalised, and changes will occur before the final
> > > release."
> > >
> > > Is it just the above paragraph that's out of date, or are the docs there
> > > out of date as well?
> >
> > It's just that paragraph, the docs are generated on a daily base by a
> > script.
>
> Not really, look at the signature at the bottom of the documentation pages.
> Also compare the documented API with the current state (e.g. alpha blending 
> is not documented):
> 
> Generated by: rich@pgr2 on Fri Sep 1 04:19:23 2000, using kdoc 2.0a36.

I found myself frustrated by the KDE developer documentation.
As someone new to KDE, it was a significant barrier to entry
for me.

Is there a KDE documentation project?  If one does not exist,
is anyone interested in starting such a project (one to produce
higher level developer documentation than the auto generated
API references)?

I'd be willing to dedicate some significant time to this - but
my experience and knowledge of KDE at this point are very very
minimal.

		- VAB

- ---
V. Alex Brennen    [vab@cryptnet.net]
  F A R  B E Y O N D  D R I V E N !
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.4 (GNU/Linux)
Comment: Made with pgp4pine 1.75-6

iD8DBQE6WUsq+pIJc5kqSz8RAgk7AJ4gZpEj2XqgmPXh7LG57p+f/EuO+QCdFnwV
95CRSaNVV7PD/l4qEo62XpE=
=DvZq
-----END PGP SIGNATURE-----



 
>> Visit http://master.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<

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