L10n:Better Documentation
From MozillaWiki
Let's make the l10n documentation better by updating, cleaning and categorizing the content available on the wikis and blogs
Steps
- Create the complete inventory of our documentation:
draft: Monday, July 13, final: Monday, August 3- chart all available resources on a single graph
- decide which documents need updating, which are obsolete and which are up-to-date
- indicate where each resource is currently located (wikimo, mdc, someone's blog, etc)
- Define our target audiences for documentation and their needs:
August 3-7, Berlin- developers - ?
- localizers - ?
- potential new contributors - ?
- l10n drivers - ?
- etc.
- Categorize:
August 3-7, Berlin- using the output from point 2, categorize existing documents into target-specific groups
- identify missing documents (create stubs)
- review existing documents with their target in mind
- decide where each document should live (wikimo, mdc?)
- move existing documents to the platform they belong to (wikimo, mdc, ...)
- make use of wiki's categories, tags and hierarchies to organize content
- Update/create content
- create missing documents as identified in step 3
- update existing documents as decided in step 3
- Create the home page
- provide useful starting points for all (or most of) target groups
- Create guidelines for maintaining and updating the documentation
- naming conventions
- should each document have an owner?
- what should we document, where and how?