====== Guide éditorial ====== 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. ===== Organisation générale et cohérence ===== Merci de le lire au moins une fois en entier avant de contribuer à ce wiki. ==== Respect du plan ==== Le [[edito:index#plan|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'[[edito:index#plan|arborescence]] du site. Notez que la façon dont les pages s'agencent est décrite [[edito:index#organisation_generale|à la suite du plan]]. ==== Identification du type de contenu ==== 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. ==== Titre et plan des pages ==== 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...) ===== Modifications ===== 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 [[#ajouter un lien vers la section concernée du forum |la partie du forum consacrée à la rédaction du wiki]]. FIXME ==== Mise à jour d'une page ==== 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). ==== Création d'une page ==== Pour créer une page: - il faut commencer par créer un lien vers cette page ((Cela permet d'éviter le problème des pages orphelines.)). - il faut ensuite vous rendre sur cette page et cliquer sur le lien "créer cette page" - pensez ensuite à prévisualiser la page créée au moyen du bouton "aperçu" - 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 [[contribution:wishlist|Wishlist]] et que vous vouliez ajouter la page [[Portage oracle]]. Vous éditez donc la page [[Wishlist|contribution:wishlist]] et y ajoutez le lien au moyen de la syntaxe ((Pour plus de précisions sur la syntaxe, reportez vous à la [[wiki:syntax|page qui y est consacrée]])): %%[[contribution:wishlist:portage_oracle|Portage oracle]]%%, puis sauvegardez votre modification en pensant à bien ajouter le commentaire correspondant. Notez ici: - tant que la page de destination n'est pas créée, le lien est rouge - L'endroit où j'ai ajouté cette page est important, comme expliqué aux paragraphes précédents: ici, elle est ajoutée en tant que fille de la partie wishlist 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... ==== Déplacement de contenu ==== 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. ===== Mise en forme ===== 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. ==== Plugins disponibles ==== Les plugins qui sont disponibles pour vous aider dans la mise en forme sont les suivants: - **wrap**: http://www.dokuwiki.org/plugin:wrap\\ Il permet de définir des boites de texte === Utilisez ces plugins === Ces plugins rendent votre texte plus clair, et plus agréable à lire. === N'abusez pas de ces plugins === Trop utilisés, ces plugins rendent votre texte illisible! ==== Versions ==== 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. ===== Qualité du contenu ===== Ce n'est pas un exercice de style, et vous n'êtes pas évalués sur vos contributions, mais souvenez-vous que: - Vos contributions seront lues par beaucoup de monde - 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 quant à la rédaction (une bonne orthographe et des phrases compréhensibles sont toujours agréables) et de 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 - signalez-le dans votre résumé - indiquez-le sur la page - demandez qu'on vous relise, ou des précisions sur le forum.