Re: volunteers needed for gtk2-perl documentation

[James Curbo <hannibal adtrw org>]

Aha, you've read my mind. I've been pondering on the documentation
lately (since I sent in that SimpleList patch). I'd be happy to help. 

Something I was thinking about though.. what do you think of pods for
each class, like gtk-perl had? One side of me thinks they would be nice,
but another side thinks they'd be hard to keep up and that people should
just read Gtk2::api and the C docs. I believe a good middle ground would
be a short example page for each class and *maybe* a listing of methods,
with "go read the C docs for more extensive info" at the end. I know a
couple of times already I've done 'perldoc Gtk2::Treeview' (for
example)...

James

On Sun, 2003-08-10 at 19:50, muppet wrote:
> we have several manpages so far, and in 0.93 they are actually linked 
> together, but we still need:
>
> - a FAQ document, e.g. Gtk2::faq, suitable for putting up on the 
> project homepage as well
> - a Cookbook/quickstart document -- Gtk2::cookbook and/or 
> Gtk2::quickstart
> - extensive editing and proofreading of what we already have
>
> any volunteers?
>
> everything should be in POD format, of course.
>
> i'm already working on binding developer documentation for Glib and 
> Gtk2, but i think i'm a little too close to the code to write something 
> aimed at people who don't already know how it works.
>
>
> --
> muppet <scott at asofyet dot org>
>
> _______________________________________________
> gtk-perl-list mailing list
> gtk-perl-list gnome org
> http://mail.gnome.org/mailman/listinfo/gtk-perl-list