Re: my atspi examples available

On 12/11/14 17:17, Magdalen Berns wrote:
> Hi Alejandro,
>
> Great idea! I'm happy to clone that and add some javascript and python 
> work, if this is useful. From my end, I would be keen to see some C 
> examples on there as I feel this would be very informative.

Ok. As I mentioned, right now there are more C examples that other 
languages examples. So a first task could be port those C examples (and 
functionality) to other language. Until they became somewhat mature, I 
prefer to maintain it as a private github repository. Anyone can use 
github issues and pull request to propose new code, instead of GNOME 
bugzilla.

>
> I suspect emphasising good documentation practice for this module will 
> increase it's usefulness to those wishing to learn from the examples 
> themselves. Perhaps it is worth taking some time to establish some 
> sort of "documentation practices" guide for the module so that 
> developers wishing to add code examples in for each of the relevant 
> languages concerned, are prompted to mind to that stuff when 
> submitting new examples?

Ok, but I don't think that something really complex or formal are 
needed. Eventually I will write a informal guide. In general, I think 
that the more important aspect is keep in mind that those are examples, 
not full programs, so they should be small, and probably focused on 
specific features/API of the libatspi library.


>
> Regards,
> Magdalen
>
> On Wed, Nov 12, 2014 at 3:24 PM, Alejandro Piñeiro 
> <[email protected] <mailto:[email protected]>> wrote:
>
>     Hello,
>
>     recently Joanmarie asked me if I had any atspi example written in
>     javascript, and I started to search my disorganized folder of
>     custom scripts, and I also found several examples most of them
>     written in C (libatspi), and one in javascript (libatspi with
>     gobject introspection).
>
>     Right now there aren't any similar thing on any official
>     repository, so I cleaned them up and uploaded on a private github
>     repository:
>     https://github.com/infapi00/atspi-examples
>
>     They are basic stuff like list the available accessible
>     applications, dump the accessibility hierarchy of a given app and
>     print out the current selected/focused accessible object on each
>     state change.
>
>     The next immediate tasks would be have equivalent examples of the
>     current C ones written in javascript and python examples (both
>     using pyatspi2 and gobject introspection). Then we could think on
>     adding more examples.
>
>     Although they need some more cleaning, I think that it would be
>     worth to eventually move them to a gnome repository. Initially I
>     was thinking on putting them directly at at-spi2-core repository,
>     but that would prevent to add non-C examples without complicating
>     too much the configure. So I think that if they become part of a
>     gnome repository, it should be also independent of at-spi2
>     repository. Would be somewhat similar to gnome-shell and
>     gnome-shell extensions. Opinions?
>
>     BR
>
>     -- 
>     Alejandro Piñeiro ([email protected] <mailto:[email protected]>)
>
>     _______________________________________________
>     gnome-accessibility-devel mailing list
>     [email protected]
>     <mailto:[email protected]>
>     https://mail.gnome.org/mailman/listinfo/gnome-accessibility-devel
>
>

-- 
Alejandro Piñeiro ([email protected])

_______________________________________________
gnome-accessibility-devel mailing list
[email protected]
https://mail.gnome.org/mailman/listinfo/gnome-accessibility-devel