BeDocs

Introduction

The main goals of Ubuntu-be does not include writing and maintaining documentation. This import job is already fulfilled by the larger Ubuntu, Ubuntu-nl, Ubuntu-fr and Ubuntu-de communities. However, Ubuntu-be can be used as a meeting point to coordinate documentations on subject specific to Belgium in the various languages spoken in our country.

Guidelines

Since we are dealing with Dutch, French German and English, some guidelines to try and keep a minimum of sync between translations:

For new articles

  • Create article in Dutch on the articles Nederlandstalige Ubuntu documentatie wiki. instructions for a portal page neeeded. Consider creating a stub articles for English, German and French translations.

  • Create article in French on the Ubuntu-fr Documentation wiki. Use the belgique tag to get your article linked from the belgique portal page. Consider creating a stub articles for Dutch, German and English translations.

  • Create article in English on the Community Documentation wiki. Add your page to the CategoryBelgianDocumentation category (see HelpOnCategories). Consider creating a stub articles for Dutch, German and French translations.

  • instructions needed for articles in German

  • In the head of your article, add links to the translations in other languages or File a bug asking translations if there is no open bug dedicated to the page.

For modifications to existing articles

  • Do not move or rename any articles unless absolutely necessary!

  • For non-trivial modifications (content addition, major rewrite, etc.)
    • Send a modification report the mailing list (subscription required).

    • File a bug asking for translations if there is no open bug dedicated to the page.

    • Consider warning reader of the other translations of the page that a more recent version exists in another language by adding a warning note on top of them.

TODO

  • Template page with header, tags, category, etc. specific to each wiki. (eg. with the belgique on doc.ubuntu-fr.org)

  • Re-usable updated information available in other(s) language(s) warning snippets for each wiki

  • this page exists in other(s) language(s) stubs in each language, with a invitation to translate

  • A Dutch portal page

  • Instruction for German articles
  • A German portal page

BelgianTeam/BeDocs (last edited 2011-03-09 17:11:43 by 94-227-10-80)