Updating documentation for 3.10

5642995221_84a6f913b7_bWith only a few hours to go until the 3.10.2 tarballs are due, here’s a recap of what the documentation team has been up to:

  • gnome-user-docs started being updated for 3.10 mid-September: it is moderately difficult to test the UI and functionality before the 3.x.92 release
  • the updates were done by 10 documentation team members and translators
  • after the docs-i18n brainstorming at GUADEC, the docs team made sure to keep translators up-to-date on what was happening
  • the changes in the UI affect almost every one of the 293 live pages
  • updating 293 pages takes a lot of time and the updates were not finished in time for 3.10.2 so there will be a 3.10.3 release sometime before next year
  • the translators appreciate the docs team how-to for taking screenshots almost as much as knowing¬† what’s going on
  • screenshots are still a pain to update
  • the docs team sucks at giving translators enough time for translations

As the docs team has been concentrating on the desktop help, some of the application help has been neglected a bit, which is somewhat unfortunate. There are also a few things that could make updating both application and desktop help easier for the team, such as fewer UI changes between each major release, notification emails about freeze breaks (not all developers send these), fewer UI and functionality changes after the freeze.

Leave a Reply

Your email address will not be published. Required fields are marked *