Re: Module proposal: Empathy for GNOME 2.24

["BJörn Lindqvist" <bjourne gmail com>]

On Tue, Mar 25, 2008 at 11:50 AM, Xavier Claessens <xclaesse gmail com> 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