BeDocs

Differences between revisions 8 and 17 (spanning 9 versions)
Revision 8 as of 2008-08-06 16:25:51
Size: 1606
Editor: localhost
Comment: converted to 1.6 markup
Revision 17 as of 2011-03-09 17:11:43
Size: 3163
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em; ">'''Contents'''<<BR>><<TableOfContents>>|| <<Include(BelgianTeam/Header)>>
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em; "><<TableOfContents>>||
Line 4: Line 5:
== Introduction & guidelines ==
This page indexes Belgium specific documentation. Since we are dealing with Dutch, French and English, some guidelines to try and keep a minimum of sync between translations:
 * For new articles:
  * Put articles in Dutch under NederlandstaligeDocumentatie -> "Voor Belgische gebruikers". Create at least a stub French translation under http://doc.ubuntu-fr.org/belgique with a link to the Dutch version.
  * Put articles in French under http://doc.ubuntu-fr.org/belgique. Create at least a stub Dutch translation under NederlandstaligeDocumentatie -> "Voor Belgische gebruikers" with a link to the French version.
  * Put articles in English under BelgianTeam/BeDocs/NameOfYourArticle. Create at least a stub Dutch and French translation under NederlandstaligeDocumentatie -> "Voor Belgische gebruikers" and http://doc.ubuntu-fr.org/belgique respectively. Link the different language versions.
 * For modifications to existing articles:
  * '''Do not move or rename''' any articles unless absolutely necessary!
  * Warn users of the other language pages that a more recent version exists in another language (with link if not present yet!).
== Introduction ==
The main goals of Ubuntu-be does not include writing and maintaining documentation. This import job is already fulfilled by the larger [[[[https://help.ubuntu.com/community/|Ubuntu]], [[http://wiki.ubuntu-nl.org/|Ubuntu-nl]], [[http://doc.ubuntu-fr.org/|Ubuntu-fr]] and [[http://wiki.ubuntuusers.de/| 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.
Line 14: Line 8:
== Belgium specific documentation == == Guidelines ==
Since we are dealing with Dutch, French German and English, some guidelines to try and keep a minimum of sync between translations:
Line 16: Line 11:
 * Online banking in Belgium with Ubuntu [[NlBeOnlineBankieren| NL]] [[http://doc.ubuntu-fr.org/belgique|FR]] [[BelgianTeam/BeDocs/OnlineBanking| EN]] === For new articles ===
  * Create article in Dutch on the articles [[http://wiki.ubuntu-nl.org/|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 [[http://doc.ubuntu-fr.org/|Ubuntu-fr Documentation wiki]]. Use the ''belgique'' tag to get your article linked from the [[http://doc.ubuntu-fr.org/belgique|belgique]] ''portal'' page. Consider creating a stub articles for Dutch, German and English translations.
  * Create article in English on the [[https://help.ubuntu.com/community/|Community Documentation wiki]]. Add your page to the [[https://help.ubuntu.com/community/CategoryBelgianDocumentation|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 [[https://bugs.edge.launchpad.net/ubuntu-belgium/+filebug|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 [[https://lists.ubuntu.com/mailman/listinfo/ubuntu-be|the mailing list]] (subscription required).
  * [[https://bugs.edge.launchpad.net/ubuntu-belgium/+filebug|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

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 jurgen-gaeremyn)