DocumentationProject/Meeting20090628

Documentation Team Meeting Agenda June 28th, 2009 21:00 UTC / 16:00 EST

Agenda

Attendance: Phil Bull, Milo Casagrande, Paul Cutler, Bruno Lambert, Jim Campbell, dino, james_w, imp 25

GNOME Docs Team recap of the Writing Open Source convention, including personal blog posts: http://live.gnome.org/DocumentationProject/Community/Woscon2009

Focus on 3 teams: Writers, Editors & Translators
Re-organizing wiki pages to reflect teams
- Need to finish wiki re-org, especially tasks / to-do list
- Milo has started to update the Translators pages, and recommends doc team members reach out to their local teams
Short discussion regarding translator challenges for documentation, and we want to encourage more documentation / translation teamwork and collaboration
Doc team is committed to regular monthly project meeting on the last Sunday of the month, and bi-weekly community / open Q&A sessions
Doc team also attended two distribution downstream meetings this month (Fedora & Ubuntu)
Launched new team blog at http://blogs.gnome.org/docs

GNOME 2.28
- gnome-doc-utils 0.17.2 and Yelp 2.27.2 have been released, and include Project Mallard support
  - Project Mallard is a new XML schema for writing desktop documentation in GNOME, with a much easier syntax and dynamic page linking
- Rarian / Scrollkeeper support is not included yet, and won't be until GNOME 3.0. Mallard documents will display fine in Yelp, but aren't listed in the categorical list of documents in GNOME Help (though applications calling Mallard Yelp documents work fine)
- Localization
  - Shaun needs help with xml2po from Danilo or similar developer. XML to PO works with the default mode of xml2po, though it needs improvement. Placeholders are in place for all inline markup, which needs to be fixed. There are currently issues going from PO to XML.
  - Stylesheet localization: Needs to be completed, but Shaun is traveling and not available the next 3 weeks. Anyone with some XSLT familiarity could probably complete it fairly easily. (Search for FIXME: i18n)
GNOME Docs Team is hoping to complete Empathy docs in Mallard for 2.28 (Phil & Milo)
- Topic based help
- CC-SA 3.0 licensed (no more GFDL)
GNOME 3.0
- Goal is to replace the GNOME User Guide and GNOME Accessibility Guide using Mallard and re-write from scratch
  - CC-BY 3.0 license
  - Topic based documentation