Comment participer et améliorer cette documentation ?

La documentation francophone d'Ubuntu est la principale source d'information francophone concernant Ubuntu et les logiciels libres. Elle est publiée sous forme de wiki, un système de rédaction ouvert et collaboratif. Tout le monde peut aider à l'améliorer chacun suivant ses talents, qu'il s'agisse de créer une nouvelle page, de mettre à jour des pages existantes, de simplifier, corriger, ou mettre en conformité avec nos normes rédactionnelles. Merci d'avance pour vos contributions!

Pour pouvoir contribuer de manière efficace, le plus important est de se coordonner avec les autres contributeurs. Deux outils sont mis à disposition dans ce but: une liste de diffusion par email, et un salon de chat. S'y inscrire n'est pas une obligation, mais c'est plus sympa et ça permet de bénéficier de la relecture et des conseils des autres contributeurs. Par ailleurs c'est utile pour discuter de ce qu'il faut changer et ça aide les administrateurs à comprendre ce qu'il se passe.

Par ailleurs il y a des règles de bon sens auxquelles il est demandé de se conformer: Se limiter au contenu tourné vers Ubuntu (ligne éditoriale), respecter la législation française (ligne éthique), respecter les contributions des autres utilisateurs (code de conduite).

Enfin il y a un certain nombre de bonnes pratiques qui seront détaillées un peu plus loin et qui visent globalement à avoir un wiki homogène rédigé dans un style neutre et avec des pages organisées de manière similaire, afin que le lecteur ne soit pas perdu en passant de l'une à l'autre.

Vous pouvez modifier n'importe quelle page simplement en cliquant sur le lien Modifier cette page dans le menu (Il n'est pas nécessaire d'être connecté mais c'est une bonne pratique). N'hésitez pas à vous familiariser avec la syntaxe du wiki en faisant des essais sur la page Bac à sable. Utilisez le bouton Aperçu pour prévisualiser vos modifications et une fois satisfait, laissez un commentaire expliquant vos changements dans le champ Résumé puis cliquez sur le bouton Enregistrer.

Pour pouvoir créer une nouvelle page, il est nécessaire au préalable de s'enregistrer (ça passe par le forum car il y a une seule authentification pour l'ensemble du site). Une fois connecté, rendez-vous sur l'url de la page que vous souhaitez créer. Par exemple si vous souhaitez créer votre page contributeur afin de vous présenter, rendez-vous sur l'url http://doc.ubuntu-fr.org/utilisateurs/MON_PSEUDO et cliquez sur le lien Créer cette page dans le bloc Actions du menu de gauche. Pour créer une page dédiée à un logiciel, rendez vous sur l'url http://doc.ubuntu-fr.org/Nom_de_la_page et faites de même.

Afin de garantir l'homogénéité du wiki, essayez pour chaque page créée ou éditée, de vous conformer à l'un des modèle proposés: Application pour parler d'un logiciel, Portable pour présenter un ordinateur, Matériel pour présenter un périphérique, Tutoriel pour les explications pas à pas, Portail pour lister les ressources en lien avec une thématique, et Utilisateur pour vous présenter sur le wiki. Si la page que vous projetez ne cadre pas avec l'un des modèles proposés, il vaut mieux poser la questions aux autres contributeurs que de se lancer dans une adaptation libre, surtout pour une première contribution.

En plus des règles évoquées dans les parties précédentes, un certain nombre de bonnes pratiques permettent de garantir la cohérence du wiki, ainsi que sa maintenabilité:

Les contributeurs qui participent régulièrement au wiki sont invités à s'inscrire sur le site et à être autant que possibles connectés lorsqu'ils enregistrent une page, car cela facilite énormément le travail des administrateurs et c'est plus convivial. Il est également recommandé de s'inscrire sur la mailing liste et le salon de discussion afin de pouvoir échanger avec les autres contributeurs, demander conseil, apporter des précisions,..

Il est également recommandé de s'abonner aux pages que vous modifiez pour pouvoir en suivre les modifications et contrôler leur évolution. Enfin vous êtes invités à créer votre espace utilisateur, afin de vous présenter, donner éventuellement un moyen de vous contacter, et disposer d'un espace pour enregistrer vos brouillons.

      Éviter les éditions répétées
éviter anglicismes
Indiquer les sources
rester simple + factuel
commencer par la base
ton neutre

  page pas déformée
  respecter modèle   
  Utiliser les tags mais modérément (+versions supportées seulement)
  Utiliser les mini-tutoriels
  respecter syntaxe (liens) + pas d'images externes #Insérer des images
  sudo

- autre méthode de création de page