Ceci est une ancienne révision du document !



Le chantier de la documentation Ubuntu-fr.org

Cette page est une sous-partie de la page "Comment participer et améliorer cette documentation ?".

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 dont l'adresse est :

    http://doc.ubuntu-fr.org/materiel/imprimante/canon 

doit devenir

    http://doc.ubuntu-fr.org/imprimante_canon

et avoir les tags correspondant ( Voir la gestion des tags) :

     {{tag>matériel imprimante brouillon}}

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

Pour déplacer une page, il faut:

  1. repérer les pages pointant vers la page à déplacer en cliquant sur Liens vers cette page dans le menu actions.
  2. créer la page à la racine avec le nom approprié.
  3. y recopier le texte exact de la page d'origine (par couper-coller).
  4. Rediriger la page d'origine vers la nouvelle page.
  5. modifier les liens des pages repérées en 1.
  6. mettre à jour les tags

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.

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.

L'origine de ces références inexistants. Dans la documentation doc.ubuntu-fr.org, il existe des liens qui n'existent pas. La couleur de ces liens morts est le rouge ce qui est très pratique pour les repérer et les corriger si nécessaire.

  • Ils peuvent être issue de contributeurs pour attirer l'attention sur des pages qui devraient (à ses yeux) être créées,

⇒ faire une demande sur la page demande_documentation si nécessaire

  • Ils peuvent résulter d'une erreur de syntaxe

⇒ Corriger le lien en éditant le paragraphe concerné

  • Ou bien de la suppression de page concernée ( vandalisme ou remaniement de la documentation concerné )

⇒ Voir l'historique de la page ( Anciennes révisions ) pour vérifier si un déplacement n'est pas en cours, repérer le nouveau lien de la documentation, modifier le lien mort. En cas de vandalisme restaurer la documentation en affichant puis en éditant une version saine ( voir dans Anciennes révisions )

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.

Voir les liens morts ;

Voir les demandes de documentations.

Corrigeons les tags ! Voir la page la correction orthographique des tags.

Les pages brouillons

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.

     {{tag><les tags existants> brouillon}}

Voir les pages brouillon.

Les pages vétustes

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, Edgy, Feisty et Gutsy.

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.

     {{tag><les tags existants> vétuste}}

Voir les pages vétuste.

Les pages à corriger

Si vous découvrez des pages bourrés de fautes d'orthographe vous pouvez utiliser le tag suivant :

     {{tag><les tags existants>  orthographe_à_corriger}}

Voir les pages orthographe à corriger.

Les pages à supprimer

De la même manière si vous considérez qu'une page est trop ancienne ou totalement inutilisable vous pouvez utiliser le tag suivant :

     {{tag><les tags existants> à_supprimer}}

Voir les pages à supprimer.

  • wiki/chantiers.1247585761.txt.gz
  • Dernière modification: Le 18/04/2011, 14:45
  • (modification externe)