Re: Improving PyGObject documentation

[John Stowers <john stowers lists gmail com>]

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