Comment participer?[edit]

Toute contribution à la documentation de Swisslinux.org est la bienvenue. Néanmoins, dans l'intérêt de nos visiteurs, nous avons fixé une série de règles à adopter afin d'harmoniser les différentes pages du wiki. Nous vous conseillons de copier le code de notre page modèle et de l'adapter en fonction de vos besoins. Consultez également les pages déjà existantes pour vous faire une idée de la façon de rédiger et de mettre en forme vos textes.

Les coordinateurs se chargent d'éventuellement déplacer, modifier ou scinder les pages afin d'organiser le mieux possible l'information. Vous pouvez également les joindre par email ou messagerie instantanée si vous avez des questions précises concernant la rédaction d'article. Référez-vous à la page des projets pour connaître les personnes responsables de la documentation.

Le moteur utilisé est DokuWiki. Veuillez tout d'abord vous familiariser avec la syntaxe, si vous ne la connaissez pas. (Vous verrez, elle est très simple.) Il y a des règles générales à respecter ainsi que quelques-unes concernant l'organisation du wiki et la syntaxe.

Règles générales[edit]

  1. Exprimez-vous dans un français correct (orthographe et grammaire) et vousoyez votre lectorat. Evitez les tournures orales.
  2. N'utilisez pas des abréviations comme “infos”, “conf”, etc. ni des anglicismes tels que “l'user”, “le package”, “plugin”, etc. N'utilisez pas non plus le pronom indéfini “on”.
  3. Evitez de surcharger votre documentation avec des phrases d'humour et des émoticônes (“smileys”). Banissez les phrases au second degré : tout le monde ne comprendra pas forcément votre humour.
  4. Limitez vous à l'essentiel et n'hésitez pas à renvoyer votre lecteur vers d'autres pages de documentation lorsque les informations qu'elles contiennent ne sont pas essentielles pour votre page. Elle restera courte et le lecteur aura une meilleure vue d'ensemble. Il pourra chercher de lui-même des informations plus précises s'il en a besoin en suivant les pistes que vous lui aurez données, grâce, par exemple, à un renvoi vers wikipédia à l'aide de liens “interwiki”: [[wpfr>article|Titre de l'article]] // Pour Wikipédia (en français)

  5. Expliquez à l'utilisateur l'effet de chaque commande, et ne rédigez pas des articles qui se résument à une succession de commandes à copier “bêtement”.

  6. Vous pouvez agrémenter votre article avec des images (logos de distribution ou de programmes) ainsi que des captures d'écran, mais gardez à l'esprit que celles-ci doivent illustrer votre propos et non le remplacer. Les captures d'écran doivent être commentées dans votre texte. Préférez des captures de fenêtres plutôt que des captures d'écran complètes qui noient l'information.

Organisation[edit]

Typographie[edit]

Coordination[edit]

Le wiki est un outil de collaboration. N'hésitez pas à y participer mais veuillez respecter les règles suivantes afin d'assurer une bonne coordination entre les différents contributeurs.

1.

Traduction[edit]

Autre[edit]