L10n:Better Documentation
Jump to navigation
Jump to search
Let's make the l10n documentation better by updating, cleaning and categorizing the content available on the wikis and blogs
Steps
- Create "Conditions of premises" of our documentation:
- 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:
- developers - ?
- localizers - ?
- potential new contributors - ?
- l10n drivers - ?
- etc.
- Categorize:
- using the output from point 2, categorize existing documents into target-specific groups
- update existing documents with their target in mind
- identify missing documents and create them
- decide where each document should live (wikimo, mdc?)
- make use of wiki's categories, tags and hierarchies to organize content
- 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?