Re: Improving PyGObject documentation



Hi John,

I don't have anything against putting it gnome.org, the source is
available in github, so everyone could use it on his or her server.

What's nice about github is that it comes with a commit hook which
automatically updates readthedocs.org which is very nice.

Best regards,
Sebastian

Am 14.02.2013 06:52, schrieb John Stowers:
Hi Sebastian,

Thanks for your work on the tutorial. I regularly refer people to it.

However I wonder if this could go on gnome.org?

I already feel <snip> that Javascript was chosen instead of python in
the latest GNOME <snip>.

Perhaps having the docs on gnome.org might go some way to remedy this.

John

On Mon, Feb 11, 2013 at 2:55 PM, Sebastian Pölsterl <sebp k-d-w org> wrote:
Dear Jonathan,

I don't see it as an API reference manual, because that would mean that
one has to maintain that manually and update it if the C reference
changes. Ultimately, this will lead to the python reference being behind
the C reference all the time.

My main purpose was indeed to write a tutorial with examples and
documentation for the functions and classes that were used in this
example. If you want to add additional examples which explain widgets
that are currently not part of the tutorial, I'd be happy to add them.

Best regards,
Sebastian

Am 10.02.2013 06:25, schrieb Jonathan Ballet:
Hi,

I'm currently working on an application which uses PyGObject and Gtk 3.
I used once or twice the informations provided in
http://python-gtk-3-tutorial.readthedocs.org/ but I mostly refers to the
official Gtk 3 documentation, which describes the C API.

There are some differences between the C API and the API provided in
Python (often, the later is more convenient :) which is not documented
in the link mentioned above.
I'm willing to help to improve this document, but I wonder what its
scope is: is it more like a tutorial with a few API references and a
'for more information, look at the C API', or is it supposed to become
eventually complete by itself?
My actual question would actually probably be: what to put inside?
Examples, explanations, missing API, ?

Regards,

 Jonathan
_______________________________________________
python-hackers-list mailing list
python-hackers-list gnome org
https://mail.gnome.org/mailman/listinfo/python-hackers-list




_______________________________________________
python-hackers-list mailing list
python-hackers-list gnome org
https://mail.gnome.org/mailman/listinfo/python-hackers-list




Attachment: signature.asc
Description: OpenPGP digital signature



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]