On Tue, Mar 25, 2008 at 11:50 AM, Xavier Claessens <[EMAIL PROTECTED]> wrote: > * Purpose: Empathy [1] consists of a rich set of reusable instant > messaging widgets, and a GNOME client using those widgets. It uses > Telepathy and Nokia's Mission Control, and reuses Gossip's UI. The main > goal is to permit desktop integration by providing libempathy and > libempathy-gtk libraries. libempathy-gtk is a set of powerful widgets > that can be embeded into any GNOME application.
I complained about this the last time libempathy was proposed (20070924). But I can do it again. libempathy and libempathy-gtk looks very interesting, but the documentation plain suck. The documentation on http://library.gnome.org/devel/libempathy/0.22/ consists of mostly empty gtkdoc generated function definitions and almost no docstrings at all. So if a library is supposed to be reusable, it needs *excellent* documentation, api documentation and tutorial style information, otherwise developers will have a very hard time reusing it. So -1 from me which I think is very unfortunate because the features look really cool. -- mvh Björn _______________________________________________ desktop-devel-list mailing list desktop-devel-list@gnome.org http://mail.gnome.org/mailman/listinfo/desktop-devel-list