start
Table of Contents

Editing the Localisation Guide

We would like you to contribute the knowledge you have to make this guide more comprehensive. The main aim of the guide is to reduce the pain experienced by most localisers in finding the correct information on specific project and in contributing for the first time.

Please add your wisdom and help save others from experiencing your pain.

First things first

Please familiarise yourself with the guide so that you are aware if any of the content you want to add is already present. We don’t want to duplicate information because if we do:

  1. The information become dated and disagrees across the different sections
  2. We’re trying to make a guide that is as general and only specific when needed and then only where needed

What goes were

The wiki contains some distinct sections:

  1. The guides to the Translate Toolkit
  2. This guide - the localisers guide
  3. A glossary of localisation terms

Each of these makes use of namespaces to distinguish sections from each other. Please make sure your editing in the right place.

The localisers guide is broken down into these broad sections:

Please place content in the relevant section. Please don’t duplicate content but rather link tot he relevant section in the other parts of the guide.

Headings

Genearly each page has an H1 heading and all other headings are below that. Please make use of section headings for clarity (it also makes it possible for other to link to your sections). Also use high level headings starting from H1 in your document as this then creates the nice table of contents automatically.

Style

We are not that particular about the style of writing (well we haven’t seen any awfull stuff yet). But please do stay to the point and feel free to give personal examples and to use personal pronouns. Eg “we have found that”. The guide text is quite formal but if you need to then add humour as needed.

Spelling and Grammar

Firstly I can’t spell! We also realise that some contributors are not native English speakers so don’t worry too much about that - or ask someone on translat-devel@lists.sourceforge.net to check you spelling and grammar. the main idea is is it understandable, could this help you learn something, start something or start contributing. If the answer is yes - then your content is probably good enough.

Licensing

This guide is under a creative commons license. Please be aware of that before adding your content and be aware that copy and paste might violate someone elses copyright - rather write from scratch or paraphrase the documents you want to copy.

Credit

Everyone want credit. Please add your name to the credits page.

Using Namespaces

The guide makes extensive use of namespaces

Eg

guide:translation:variables

refers to the variables page in the translation section of this guide

Adding another language or translating

Please make use of namespaces to seperate your translations from the main document. Use your languages iso639 code as the namespace. For Zulu this page would be refered to as

zu:guide:editing