First off, to give it some context I wrote a short intro on our beginner page,
Second, so far I've been working on code samples, each one documenting a specific Gtk widget. You can see a list of the ones that I and the other interns and mentors have done so far on our wiki page,
although it doesn't include a few that I've submitted but that haven't been approved yet. Fellow intern Marta Maria Casetti
is way ahead of me with the Python documentation ... I'm trying to keep up! Tiffany Antopolski,
my mentor, has helped a lot, including by writing a few of the code samples so I'd have a starting point.
One thing Marta and I have been trying to do is make the code samples more interesting. Here's an example
of a code sample I got a little creative with! Not only does it give an intro to the Creative Commons, it goes beyond a basic "switch" example by showing how you can use multiple switches together. I've found that by figuring things like this out, and how to lay out windows to accomodate them, I've been learning a lot about application development.Challenges -- Short term
Third, I'm concerned about how much of it will have to be rewritten if and when Anjuta and Glade catch up to modern Gtk widgets, like the ApplicationWindow. Because it seems like they've lagged behind for ages, and yet at the same time I'm told they're supposed
to be the preferred development environment for GNOME.
I'm given the impression that most "real" GNOME hackers use Emacs or something, and I personally suspect this to be a big part of the reason there aren't many GNOME app developers.
At any rate, I'm probably going to assume that readers are using Gedit for development until and unless something changes.Challenges -- long term
Even once the documentation's complete, I'm not sure how anyone will ever find it. Here's GNOME's developer website;
you've got one option that says
"Beginner tutorials" and four others that are
First off, finish the code samples, including re-writing some earlier ones to update them.
Third, develop an actual GNOME game or app of some kind, that uses libraries like Telepathy, and work its development into the tutorials (i.e. teach people how to make it).
Beyond that, it'd be great to cover internationalization and accessibility throughout the course and the samples, and
to have a guide explaining how to create GNOME Shell extensions. Carlos Sorianno started an attempt at this,
and I'd like to polish and add onto it (if nobody else beats me to that).
I also need to apply to the GNOME Foundation for financial assistance in order to attend OpenHelp.