Que faire pour aider la documentation

Ceci est une ancienne révision du document !

Pour simplifier la gestion des pages, il a été décidé fin 2006 de passer d'un système de sous-répertoires à un système de tags. En conséquence, il est demandé à la communauté des contributeurs du wiki de déplacer "à la main" toutes les pages contenues dans les sous-répertoires vers la racine à l'exception notable de celles contenues dans: projets, wiki, dépôts, utilisateurs, category, installation, tutoriel et canada.

Ainsi, une page materiel/imprimante/canon_xxx doit devenir /imprimante_canon_xxx et avoir le tag matériel (notez l'accent). besoin d'autres exemples

Vous pouvez repérer les sous-répertoires existants en cliquant sur Index dans le menu actions.

Pour déplacer une page, il faut:

repérer les pages pointant vers la page à déplacer en cliquant sur Liens vers cette page dans le menu actions.
créer la page à la racine avec le nom approprié.
y recopier le texte exact de la page d'origine (par copier-coller).
rediriger la page d'origine vers la nouvelle page.
modifier les liens des pages repérées en 1.

La procédure ci-dessus ne vaut que pour les pages importantes qui peuvent avoir un grand nombre de pages pointant vers elles (notamment des pages extérieures). Pour les autres, il est préférable de ne pas créer de redirection et d'effacer la page d'origine(en effaçant simplement tout son texte).

A l'heure actuelle, toutes les pages applications ont été déplacées, il ne reste que des sous-répertoires vides.

Lorsqu'une page est créée, il y est accolé le tag BROUILLON. Ce tag est censé diriger les contributeurs vers les pages à améliorer en priorité. Vous êtes donc invité à aller voir ces pages afin de retirer le tag BROUILLON de celles qui vous semblent finies ou de compléter celles sur lesquelles il reste du travail.

Il a été décidé de créer des pages portail à la place des lourdes pages d'accueil afin d'améliorer la clarté de l'accueil et de la documentation en général.

Voir la discussion de la Mailing-list pour plus de détails.

Un contributeur peut être amené à donner un lien qui pointe vers une page qui n'existe pas. C'est soit pour attirer l'attention d'autres contributeurs sur des pages qui devraient (à ses yeux) être créées, soit … une erreur. Il existe une page qui recense ces liens morts. Elle regorge de besoins et d'erreurs, si vous parvenez à combler un des premiers ou à réparer un des seconds, soyez-en remerciés.

Avec le temps, certaines pages deviennent entièrement ou partiellement vétustes. c'est notamment le cas des pages faisant référence aux versions qui ne sont plus supportées. Il faut donc soit les effacer, soit les mettre à jour. Actuellement, les versions non-supportées sont Warty, Hoary, Breezy et Edgy.

A l'inverse, si une page comprend des indications correctes pour votre version d'Ubuntu mais ne comporte pas le tag en question, vous êtes invité à le rajouter.

Indépendamment de la gestion des versions, si vous soupçonnez qu'une page est vétuste mais vous n'avez pas le temps ou la compétence pour régler le problème, vous pouvez y placer le tag vétuste.