After the first two “official” days of the Open Help Conference, GNOME Docs team “officially” started their second hackfest this year.
The plan was to revamp the Platform Overview with info from the recent DX hackfest and overhaul the developer.gnome.org. First day saw a lot of brainstorming, rearranging of post-its with existing and to-be-written topics, and engaging in some animated discussions about the appropriate type of support material for the new contributors.
Shaun and Kat reworked the index and structure of the new platform overview, Michael wrote the stub pages about preparing the applications for translation, Gord updated the Get started tour, Tiffany finished the Vala examples for platform demos, and I wrote the stub pages about the procedure for adding user help to applications. Our resident programing wizards, Dave and Ryan, did the reviewing and answered a lot of questions. The results can be seen in master in the new-platform-overview directory.
Ryan also embarked on a new endeavor: motivating experienced GNOME developers to contribute to documentation by making the How Do I? style tutorials about the new technologies in GNOME. The idea seems to have taken roots and there are already various tutes written on the wiki, together with How do I write a HowDoI?
On the last day I took some time to contribute a couple of patches and revisit the user docs of Getting Things GNOME and Gtranslator apps (which were my last year’s GOPW projects) since they needed an update of the license information for all the Mallard pages. I should dedicate some time to a serious revision of GTG user docs, and follow closely this year’s GSOC project to redesign and port Gtranslator to Vala. The new app has the work-in-progress name ValaCAT and the code is on GitHub.
Far from being all-work-no-play, hackfest also meant we gathered daily with other teams that were doing sprints (Wikipedia, WordPress, FreeBSD…), enjoyed Cincinnati gastronomy and the intriguing experience of bourbon tasting with Molly Wellman, one of the best local bartenders. The atmosphere of Japp’s Since 1879 in Cincinnati’s historic Over the Rhine neighborhood was quite movie-like.
The last evening Shaun took us to Mount Adams (gorgeous view of Cincinnati downtown, day and night), for the farewell dinner in a real pottery kiln!!! That was the first for me…
Thanks to Shaun McCance for organizing the conference and sprints (and yes, I was serious about doing it in Barcelona in the future!), and Mozilla, WordPress, GitHub and Red Hat for their sponsorship. My participation was possible thanks to the GNOME Foundation generous travel grant.