Tag Archives: hackfest

GNOME Docs in Cambridge: day two

Working hard (or lazing around)

Day two of the hackfest saw more progress…

Application and desktop help

I worked on merging new games documentation which was written by Rashi Aswani and fixing some of our 100-odd bugs against application help which Petr Kovar has continued triaging.

Jim Campbell started refactoring Files (nautilus) desktop help as the style of the pages was a bit outdated. It now looks awesome.

In the mean time, Jana Švárová continued powering through the feedback.

Licensing

gedit documentation saw some licensing improvements thanks to Jim. A number of the help pages had previously been published without a license which is something that the team has been fixing over the last few years. Adding the license after the pages have been written is a bit of an arduous task. Progress has been slow but steady.

Developer Documentation

Bastian Ilsø and David King made further progress on gnome-devel-docs. Bastian made improvements to the first user experience of writing an application using the platform demos and learnt the importance of validating the XML.

yelp

Around August 2014, the documentation team started accepting emailed feedback about the documentation from help.gnome.org. It has been quite a success and yelp will see this feature as soon as Shaun McCance can build it.

Mallard

Shaun also improved projectmallard.org, the home of Mallard, and furthered the development of DuckType, a markdown Mallard language.

The end

We finished the day with lovely cream tea, which caused a number of altercations due to cultural and regional conflicts.


COLLABORA_03_PMS

Documentation, GUADEC and more documentation

It is traditional for the documentation team try to meet a few times per year for hackfests, alternating between Europe and North America to help the whole team make it to at least one event per year. The hackfests serve two purposes: getting work done and motivating/rejuvenating the team.

This year, we met in Norwich to work on user docs for 3.12, in Berlin for the developer experience hackfest, at GNOME.Asia to guide new contributors to GNOME and at Open Help in Cincinnati for the best documentation conference and lots of awesome improvement to the sysadmin guide. We also hung out together at GUADEC. It’s unfortunate that not all the team members could make it to Open Help and GUADEC.

Sitting down for tea

GUADEC was interesting this year. It was great to meet up with old friends, meet lots of new people (/me looks at Shobha) and new old people who I should have long since met by now. Tarte flambée and whisky were had by all. Hair happened to some. Tea, damsons and mirabelles also happened (shortly after we returned, I found a mirabelle tree in the shared green space across the road from our house). It was nice to see everyone enjoying themselves at the picnic and football. Bastien always wins.

It was a shame to not see as many documentation team members at GUADEC as we’ve had in previous years and the team didn’t really have a proper hackfest either (although we did participate in a screenshot automation BoF). Spending two days in board and adboard meetings isn’t fun, but is necessary and generally much more productive than phone meetings. I was disappointed to see an anti-harassment policy for the conference: it is a shame that it is thought that the community is tending in the direction of harassing behaviour to a point where there is a requirement for the community to enforce the law (harassment and discrimination are illegal in many, if not all, European countries). I want to be part of a community built on mutual respect, not distrust and inability to communicate. It also seems that the policy can only be used by specific individuals, not everyone, which does seem counter-productive.

It seemed to me, having been involved in GUADEC organisation for the last four years, that 2014 was an especially challenging year. I appreciate all the work that Alexandre and the team have put into making it happen. I foresee even more challenges for 2015, but I’m sure that we will all be there to support the new team.

3.14 was a bit of a slow release cycle for documentation as the team as a whole have not had much free time to work on updating it. I would like to thank the translation teams for being awesome and helping out by filing bugs and patches (both of which are very welcome). There are currently rather a lot of documentation patches and branches to review, so I will be concentrating on those in the next few weeks. I hope that the team will be able to hold another hackfest in January or February to prepare for 3.16, but this is currently a bit of an uncertainty unless we can find sponsors to help with travel. If you know of anyone interested in sponsoring the hackfest please get in touch with the team or with me.

Thank you to the GNOME Foundation for sponsoring my travel and accommodation at GUADEC, and to Liam, Ella, Finn and Martin for looking after the chickens. I wouldn’t have been able to make it to GUADEC without you.


Developer documentation

The 2014 Developer Experience hackfest has just started at the Endocode office in Berlin. It was great of Chris to offer the space to us!.

=BERLiN!

GTK+ datamodels, API docs and hand written docs will be discussed today. The hand written docs will cover the developer documentation which comes from gnome-devel-docs and Ryan‘s HowDoI series on the wiki.

This evening, we are going to join the Berlin Open Source Meetup at the Prater. If you want to talk to us, come and join us!

Tomorrow we will move onto the GTK roadmap, including the new HIG, development tools and developer.gnome.org.