Hi from the Documentation Hackfest at GUADEC 2013! Federico Mena Quintero, Meg Ford, Emily Gonyer, Seif Lotfy, Max Huang and I had a very productive brainstorming session. So, this is what we are planning to do:
0. We will keep on working on the idea of the "Tutorials for beginners" in C (task: Julita Inca) JavaScript (task: Meg Ford) and Python (task: Marta Maria Casetti). Emily Gonyer: help for all. But... 1. *Changes in titles* The current titles use the "for beginners" expression too much. This can discourage programmers that know a language (or another library) quite well from considering these resources. So: * "Tutorials for beginners" (the index.page) should become "GATEway to programming (GNOME Application Tutorials for Everyone)". (Thank you, Emily!) * "GTK Tutorial for beginners" becomes "GTK tutorial" (in each language, to be followed by "[library] tutorial" in the future). * "10 minutes tutorial" (see below) become "Sample applications" (the rationale behind this is that if you are not able to complete the example in 10 minutes you will feel bad and lose interest). 2. *What is in "Sample applications"?* synopsis: The following are examples of applications for the GNOME desktop environment Example 1 (Text Editor) Example 2 (Image Viewer) Example 3 (Temperature converter) Example 4 (Contact list - using Treeview) (Thank you, Federico!) ...suggestions welcome, both for simpler and more complex examples! 3. *Making the tutorial more available* Each "GTK tutorial" should have a downloadable version (a .zip directory with .pdf of tutorial and .c/.js/.py files of samples) (Thank you, Emily and Meg!) 4. *Making the tutorial more challenging* For each tutorial there should be an application to test knowledge and earn "badges". (Thank you, Max!) Now: plan of the attack! I (i.e.: Meg, Julita and I) would start by working on the "GTK tutorial", since we should refer to that in the "Sample applications" (in each example we should link the "pieces of the puzzle" needed to build the sample application), and that points 3. and 4. need the tutorial to be completed. Description of the structure of the tutorial: another email, or this one will become longer than "War and Peace". If anyone would like to write a first draft of the "sample applications": thank you, and let everybody know what you are planning to do via mailing list so that there are not two people working at the same example not coordinating with each other. I hope to talk to you soon! All the best, Marta _______________________________________________ gnome-doc-list mailing list [email protected] https://mail.gnome.org/mailman/listinfo/gnome-doc-list
