Re: gtk+ documentation wikified

[Mathias Hasselmann <mathias hasselmann gmx de>]

Am Donnerstag, den 19.02.2009, 10:33 -0500 schrieb Dominic Lachowicz:
> That's hard-ish to do today. GTK+'s documentation is generated in
> large part by scanning comments in C code, which a program then turns
> into HTML. Any proposal would require a way to keep the Wiki and the C
> comments in-sync.

Still that proposed idea has some merits: Currently entry barrier for
fixing GTK+ docs still is quite high.

Guess the most trivial fix would be, to do what the PHP community does
and attach some comment system/forum to library.gnome.org.

More sophisticated would be some application that allows editing of API
docs via web site and provides some way to easily merge them back. Maybe
automatic commits to some separate branch? Maybe just additions to some
patch queue? Don't know. But maybe a nice SoC project?

Ciao,
Mathias

> 
> On Thu, Feb 19, 2009 at 10:28 AM, Eugene Gorodinsky
> <e gorodinsky gmail com> wrote:
> > Hi all
> >
> > Since you guys are discussing the redesign of the gtk+ website, I'd
> > like to propose an idea that I have. I've seen quite a lot of comments
> > saying gtk+ documentation isn't as good as qt's. What do you think of
> > having a wiki that documents all of gtk+ api?
> > _______________________________________________
> > gtk-devel-list mailing list
> > gtk-devel-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gtk-devel-list
> >
> 
> 
> 

-- 
Mathias Hasselmann <mathias hasselmann gmx de>
Personal Blog: http://taschenorakel.de/mathias/
Openismus GmbH: http://www.openismus.com/