Re: Minutes of the GTK+ Team IRC meeting - 2008-05-13

["A. Walton" <awalton gnome org>]

On Wed, May 14, 2008 at 3:15 PM, Stefan Kost <ensonic hora-obscura de> wrote:
> Hi,
>
> Emmanuele Bassi schrieb:
>> = minutes for the 2008-05-13 meeting =
>>
> 8< snip 8<
>
>>
>> * rework the gobject tutorial
>> - it is old and unmaintained
>> - the signals section is broken
>> - teaches bad practises
>
> I can go over it. Please send me pointers to what you want to have changed. From
> my own todo list:
> * G_DEFINE_TYPE and the like could be added (although I dislike their limmitations)
>
> Speaking of docs. Whats the opinion of gtk/glib developers regarding inline
> api-docs. I am much in favour of them. If the core developers are for it, we
> could do a joint effort and move the docs. I did that once for gstreamer.
> Unfortunately glib/gdk/gtk/gtk-pixbuf is too much for one person.

When asked on IRC (I'm not sure if it was me who asked or if it just
came up in discussion though; happened back when I was working on docs
for GIO so it's been a while), mclasen responded that he was in favor
of inlining the documentation, and that he was doing it as he went
along instead of just doing a mass move all at once (/paraphrase). I
don't know if that means he's against the mass move or not, we could
use him chiming in on this part.

I completely agree with you on this though, and I'm available to help
if this is something we really want to knock out. Having the docs in
the code means it's more likely the documentation will get touched
when the related code is touched, which means, at least in theory,
we'll have better documentation everywhere which is definitely a good
thing, for newer programmers and people like me with short attention
spans and bad memory.

Maybe we should put this on the next meeting's agenda?

2 cents, etc,
-A.Walton

> Stefan
>>
>> irc log available at: http://live.gnome.org/GTK+/Meetings
>> next meeting: 2008-05-27, 20:00 UTC
>>
>> ciao,
>>  Emmanuele.
>>
>
> _______________________________________________
> gtk-devel-list mailing list
> gtk-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/gtk-devel-list
>