KDE Frameworks Documentation

[Thomas Baumgart]

Hi Myriam,

on Wednesday 28 September 2011 10:26:19 Myriam Schweingruber wrote:

> Hi Ignat,
> 
> On Tue, Sep 27, 2011 at 20:30, Ignat Semenov <ragnarokk91 at gmail.com> wrote:
[...]

> > This means:
> > 
> > 1)API docs up-to-date and with extensive examples.
> 
> Since the API documentation is extracted automatically, I would expect
> it to be rather up-to-date

This does not give any information about the contents of the documentation. It 
could be up-to-date and still a bit too slim (I try to avoid empty here) at 
the same time. Autogeneration does not take the burdon from the developer to 
write documentation in the first place. Extensive examples - as requested from 
Ignat - would be a great plus.


-- 

Regards

Thomas Baumgart

GPG-FP: E55E D592 F45F 116B 8429   4F99 9C59 DB40 B75D D3BA
-------------------------------------------------------------
Dear inventor of German: You forgot to define a translation for
'resize' (as verb). Please fix. -- Sebas Kügler
-------------------------------------------------------------
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 225 bytes
Desc: This is a digitally signed message part.
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20110928/ff7d65c7/attachment.sig>