Ceci est une ancienne révision du document !



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 connaître les autres façons de contribuer à Ubuntu, consultez cette page.

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 discussion. 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.

Merci d'aviser les autres contributeurs via la liste de diffusion ou le salon de discussion pour toute création de page et pour toute modification d'importance.

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 aller plus loin..

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. Pour aller plus loin..

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é:

Contributeur

Les contributeurs qui participent régulièrement au wiki sont invités à s'inscrire sur le site et à être connectés lorsqu'ils enregistrent une page, car cela facilite énormément le travail des administrateurs et c'est plus convivial. Il est de plus 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,..

Pensez par ailleurs à vous 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.

Rédaction

Il est important de savoir garder un ton neutre, de parler à la troisième personne et d'être factuel dans un style encyclopédique: Éviter l'emploi de la premier personne qui est subjectif (j'ai fait ceci, je vous conseille cela). En effet cela revient à s'approprier une page pour soi et c'est contraire à l'esprit d'un wiki collaboratif qui se veut écrit par la communauté, pour la communauté. Dans le même ordre d'idée il est conseillé d'éviter d'exprimer une opinion, ou d'établir des hiérarchisations à caractère personnel: le wiki ne prend pas parti, il établit des faits, et autant que possible il cite ses sources (pensez à les indiquer en bas de page).

Il est également important de rester aussi simple que possible. Les longues phrases alambiquées embrouillent généralement plus qu'autre chose. Aussi il est préférable dans la mesure du possible d'éviter les ellipses et d'aller au cœur du sujet par des phrases simples et courtes en évitant les mots savants lorsqu'un synonyme plus courant peut faire l'affaire. Il est également demandé d'éviter les anglicismes lorsqu'un mot existe en français pour parler d'une notion. Enfin, il est recommandé de commencer par la base: expliquer les notions les plus évidentes vous permettra de mettre en confiance les lecteurs les plus timides.

Syntaxe

Pour bien comprendre l'usage des balises du wiki, se référer à la page Syntaxe de mise en page, ainsi qu'à la documentation Dokuwiki. Un certain nombre de considérations sont à prendre en compte:

  • Pour éviter que la page puisse être déformée, en particulier sur des petits écrans, il faut éviter de mettre de très longues chaines de caractères comme des liens http. Il est recommandé d'utiliser en lieu et place les balises dédiées du wiki pour les liens externes, avec un alias. En cas de doute, redimensionnez votre navigateur pour vérifier que votre texte ne déborde pas du cadre.
  • Pour garantir l'homogénéité du wiki, il faut s'astreindre à coller aux modèles.
  • Un certain nombre d'actions très courantes a fait l'objet de Mini-tutoriels, qui expliquent par exemple comment installer un paquet, passer en administrateur, modifier un fichier, etc. Il faut les utiliser en priorité plutôt que de réexpliquer la même chose dans chaque page
  • En particulier il est demandé de ne pas donner de commandes en sudo. Car toute évolution de l'emploi du sudo dans les prochaines versions d'Ubuntu obligerait alors à modifier toutes les pages qui en font usage (comme ça va être le cas pour Wayland). Utiliser à la place le mini tutoriel « avec les droits d'administration »
  • N'insérez pas d'images externes car cela complexifie les exports de la doc. Référez-vous au tutoriel Ajouter une image dans votre document
  • Mettez absolument des tags mais n'en abusez pas, car si une page sans tag est une page perdue, à l'inverse une page qui a des tags sans rapport direct surcharge inutilement le moteur des tags. Exemple: mettez le tag administration sur une page qui explique comment administrer Ubuntu, mais pas sur les pages des logiciels qui ont besoin des droits d'administration.
Voir la page Groupe Ubuntu-fr documentation pour mieux comprendre le fonctionnement de notre communauté

La liste de diffusion

Une liste de diffusion permet à toutes les personnes qui s'y sont inscrites de recevoir les mails que l'une d'entre elles y envoie. Au niveau de la documentation Ubuntu, cela représente une demi-douzaine de courriels par jour environ. Il ne faut donc pas avoir peur d'être envahi car de nos jours les clients mails permettent de classer facilement ces courriels dans un dossier spécifique avec délestage régulier si nécessaire.

Certains contributeurs trouvent le concept dépassé mais la plupart des projets libres continuent de s'appuyer dessus car il n'y a pas besoin d'aller chercher l'information sur une application tierce ou un forum: elle vient vers vous toute seule, vous pouvez configurer des notifications sur certains mots clé et filtrer comme bon vous semble. Par ailleurs, les clients mails modernes agrègent les conversations par sujet ce qui est très pratique (ça revient à avoir un forum dans sa boite mail) et permet de distinguer facilement quel fil de discussion se rapporte à quel sujet, chose qui n'est pas toujours facile avec les applications de messagerie instantanée.

Pour toutes ces raisons notre liste de diffusion reste notre outil principal de collaboration autour du wiki. Voici le lien d'inscription. Ne commettez pas l'erreur de vous croire trop inexpérimenté pour y participer car tous les profils sont présents, et tous sont bienvenus ;).

Le salon de discussion

L'ancien salon IRC sur Freenode, #ubuntu-fr-doc est désormais abandonné car les gens n'allaient pas dessus. En attendant de disposer d'une solution pérenne hébergée par les serveurs de l'association, nous avons opté pour un salon de chat framateam. Voici un lien direct d'invitation. Une fois connecté, cliquez sur Plus.. dans le menu de gauche, pour accéder à tous les canaux, et notamment le canal doc, où se tiennent la plupart des débats.

Cette solution, qui reste temporaire, a été choisie pour les raisons suivantes: c'est libre, en français, c'est géré par une association qui promeut les logiciels libres, et c'est basé sur le logiciel open source mattermost pour lequel il existe des clients pour les systèmes d'exploitation et les mobiles les plus courants, Debian y compris. Le fait de devoir s'inscrire constitue une contrainte supplémentaire par rapport à IRC, largement compensée par les fonctionnalités supplémentaires parmi lesquelles l'accès à l'historique de tout ce qui s'est déjà dit, et la recherche facile par mot clé.

Un navigateur récent est requis pour pouvoir accéder au client web (Firefox 52+, Chrome 43+)

Par où commencer?

Vous pouvez commencer par corriger les fautes d'orthographe, puis améliorer les pages des sujets que vous connaissez bien. Ensuite, votre aide sera appréciée notamment pour les appels à contributions qui apparaissent régulièrement sur la mailing-list du wiki, et les chantiers en cours du wiki ! :-)

Pour aller plus loin...

Cette page, ainsi que la page Syntaxe de mise en page rappellent des généralités sur la rédaction d'un wiki, et développent les spécificité de notre wiki et de nos choix éditoriaux. Cependant elles ne couvrent pas toutes les possibilités de dokuwiki. N'hésitez pas à en consulter la documentation officielle pour creuser! Par exemple, il existe d'autres méthodes de création de page que celle présentée ici donc certaines vous paraitront peut être plus intuitives.

  • wiki/participer_wiki.1509034883.txt.gz
  • Dernière modification: Le 26/10/2017, 18:21
  • par fabux