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.
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:
The wiki contains some distinct sections:
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.
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.
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.
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.
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.
Everyone want credit. Please add your name to the credits page.
The guide makes extensive use of namespaces
Eg
guide:translation:variables
refers to the variables page in the translation section of this guide
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