Ce guide est un ensemble de règles à respecter lors de votre contribution à ce wiki, que ce soit par la création ou la mise à jour d'une page.

Merci de le lire au moins une fois en entier avant de contribuer à ce wiki.

Le plan de ce wiki veut le rendre accessible à tous, habitué de freedom ou néophyte, développeur ou curieux, vous, nous….

Afin de garantir cette accessibilité, il est important de bien positionner votre page dans l'arborescence du site. Notez que la façon dont les pages s'agencent est décrite à la suite du plan.

De même, afin que le lecteur sache tout de suite s'il a affaire à une page technique ou à une page générale, il est important de ne pas mélanger ces 2 types de contenu: n'hésitez pas à créer 2 pages, et à faire des liens entre elles, tout le monde s'y retrouvera mieux en fonction de son besoin.

Lorsque vous créez une page, donnez lui un nom explicite, ainsi qu'un titre lui aussi compréhensible. Cela simplifiera les recherches. Pensez également à créer des sections avec des titres de différents niveaux, afin de structurer votre contenu: il n'y a rien de plus pénible que de devoir lire une page complète pour savoir si elle est susceptible de contenir l'information recherchée. (Mais n'abusez pas non plus, trop de sections rendent le texte illisible…)

Vos contributions sont les bienvenues, et vous êtes libres de modifier le contenu des pages ou d'en créer (vous êtes mêmes invités à le faire en cas d'information incomplète ou erronée), mais rappelez-vous que vos modifications ne sont pas anodines. En cas de doute, n'hésitez pas à consulter la partie du forum consacrée à la rédaction du wiki.

Lors de la mise à jour d'une page, pensez à bien renseigner le résumé de cette mise à jour. Cela permet de suivre l'historique du site au moyen des flux RSS. Assurez-vous également de bien modifier la bonne page, et que cette modification est légitime (Rappelez-vous que dans certains cas, il est plus judicieux de créer une page que d'en surcharger une autre).

Pour créer une page:

1. il faut commencer par créer un lien vers cette page ¹⁾.
2. il faut ensuite vous rendre sur cette page et cliquer sur le lien “créer cette page”
3. pensez ensuite à prévisualiser la page créée au moyen du bouton “aperçu”
4. sauvegardez.

Assurez-vous de mettre la page au bon endroit, et demandez-vous si cette création est légitime (Rappelez-vous que dans certains cas, il est plus judicieux de compléter une page exsistante que d'en créer une nouvelle qui n'a aucun sens par elle-même).

Imaginions, par exemple que vous soyez sur la page Wishlist et que vous vouliez ajouter la page Portage oracle. Vous éditez donc la page contribution:wishlist et y ajoutez le lien au moyen de la syntaxe ²⁾: [[contribution:wishlist:portage_oracle|Portage oracle]], puis sauvegardez votre modification en pensant à bien ajouter le commentaire correspondant.

Vous pouvez ensuite suivre le lien créé, et cliquer sur “Créer cette page” (en bas de la page). Il ne vous reste alors plus qu'à rédiger…

C'est probablement la moins anodine de ces opérations. Lorsque vous déplacez du contenu, soyez clair sur ce déplacement: ajoutez un lien à la place du contenu supprimé, et éventuellement une note là où le contenu est inséré. Cela permettra à ceux qui avaient l'habitude de venir à un endroit de ne pas être (trop) perturbés par ce changement.

La mise en forme est un élément important de vos pages: Plus la mise en forme sera claire, plus vite les lecteurs auront accès à l'information.

Les plugins qui sont disponibles pour vous aider dans la mise en forme sont les suivants:

1. wrap: http://www.dokuwiki.org/plugin:wrap
   Il permet de définir des boites de texte

Ces plugins rendent votre texte plus clair, et plus agréable à lire.

Trop utilisés, ces plugins rendent votre texte illisible!

Lorsque ce que vous écrivez concerne une version spécifique de freedom, il est important de le préciser de façon claire:

• Les contenus freedom 2.* et 3.* doivent être sur des pages distinctes
• lorsque les spécificités liées à une version ne portent que sur quelques détails, il n'est pas nécessaire de créer une nouvelle page, et l'utilisation des plugins pré-cités peut rendre les choses claires.

Ce n'est pas un exercice de style, et vous n'êtes pas évalués sur vos contributions, mais souvenez-vous que:

1. Vos contributions seront lues par beaucoup de monde
2. Cette documentation est une passerelle pour les gens qui découvrent ou utilisent freedom.

Il vous est donc demandé de faire un minimum d'effort quand à la rédaction (une bonne orthographe et des phrases compréhensibles sont toujours agréables) et à ne pas hésiter à corriger les quelques coquilles, typos et autres qui peuvent se glisser dans les contributions de chacun.

Enfin, lorsque vous avez un doute sur ce que vous rédigez

1. signalez-le dans votre résumé
2. indiquez-le sur la page
3. demandez qu'on vous relise, ou des précisions sur le forum.