I've stated to document some of pygtk.
This mail has two purposes
1.- Make sure anyone isn't making this job
2.- Get some feed back.
If any one is doing this job please tell me, I have spent some hours
learning docbook and doing some boring editing. I don't want to waist my
time doing useless things.
I have started two projects witch have failed(for unexpected technical
reasons):
http://laguna.fmedic.unam.mx/~daniel/glogo/
http://laguna.fmedic.unam.mx/~daniel/gvoice/
I don't want to make another sequel to my flops...
Brief summary of how I plan to do documentation.
This are the chapters I'm writing :
<chapter id="Gnome documentation overview">
</chapter>
<chapter id="pygnome architecture">
</chapter>
<chapter id="pygnome examples">
</chapter>
<chapter id="pygnome conventions">
</chapter>
<chapter id="Cool pygnome examples">
</chapter>
I think I will base heavily the documentation in George Lebl tutorial
Application Programming Using the GNOME Libraries.
I think it will be required to understand the documentation:
It's a good and quick intro to GNOME.
-----
Priorities:
==========
I plan to do the easy things first like:
1.- Format nicely the examples and put them in a sgml->html document with
screen-shoots so it can be a sort of quick reference.
I will save the usual steps of:
cd /usr/doc/pygtk-0.6.3/ or /usr/doc/pygnome-1.0.50/
python <What ever example you want to run>
and emacs C-x-s <the widget I'm triying to make work>
And give some taste of pygnome to new or prospective user.
2.- Make a more nice and slow explanation of the README files of James.
Sorry I'm not that much of a hacker I have read them several
times and there still things I don't understand completely...
3.- I think we should put some source tree convention like the
gnome-ones...
There are a lot of things in the source-tree in the GGAD that
aren't necessary in pygnome.
4.- Put some nice hacks to show why it's soooooooooooo nice to make GUI's
in python.
5.- Put some other interesting things like glade stuff....
Hope to hear from you soon.
Daniel Kornhauser.
To unsubscribe: echo "unsubscribe" | mail [EMAIL PROTECTED]
