{{tag>wiki comment_participer}} ====== 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 [[wpfr>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 d'autres façons de contribuer à Ubuntu, consultez [[:comment_participer|cette page]]. ===== Les règles du wiki ===== Pour pouvoir contribuer de manière efficace, il est utile de se coordonner avec les autres contributeurs et contributrices. Deux outils sont mis à disposition dans ce but : le [[https://forum.ubuntu-fr.org/viewforum.php?id=208|forum]], et un [[#le_salon_de_discussion|salon de discussion]]. Communiquer n'est pas une obligation, mais c'est plus sympa et ça permet de bénéficier de la relecture et des conseils de tiers. Par ailleurs c'est très utile pour s'informer et discuter de ce qu'il faut changer. Aussi, il y a des règles de bon sens auxquelles il est demandé de se conformer : * Se limiter au contenu tourné vers Ubuntu ([[wiki:ligne_editoriale|ligne éditoriale]]) ; * Respecter la législation française ([[wiki:ligne_ethique|ligne éthique]]) * Respecter les contributions pertinentes des autres utilisateurs ([[:codedeconduite|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 à avoir un wiki //homogène// rédigé dans un style neutre et avec des pages organisées de manière similaire, afin qu'on ne soit pas perdu à la lecture en passant de l'une à l'autre. Ne vous sentez pas bloqué·e par le grand nombre de bonnes pratiques : ces recommandations simplifient le fonctionnement du wiki, vous les apprendrez petit à petit, et les autres contributeurs et contributrices "rectifieront le tir" si nécessaire grâce au [[https://forum.ubuntu-fr.org/viewforum.php?id=208|forum]]. ===== Apprendre à créer et à modifier des pages ===== Merci de prévenir les autres contributeurs et contributrices via le [[https://forum.ubuntu-fr.org/viewforum.php?id=208|forum]] pour toute création de page et pour toute modification majeure. ==== Les modèles ==== Afin de garantir l'homogénéité du wiki, essayez, pour chaque page créée ou éditée, de conformer si possible vos contributions à l'un des modèles proposés : * pour parler d'un logiciel, le modèle [[wiki:modeles:application|Application]] ; * pour présenter un périphérique, le modèle [[wiki:modeles:materiel|Matériel]] ; * pour des explications pas à pas, le modèle [[wiki:modeles:tutoriel|Tutoriel]] ; * pour lister les ressources en lien avec une thématique, le modèle [[:wiki:modeles:portail|Portail]] ; * pour vous présenter sur le wiki, le modèle [[wiki:modeles:utilisateur|Utilisateur]]. Si la page que vous projetez ne cadre pas avec l'un des modèles proposés, il vaut mieux poser la question aux autres contributeurs et contributrices que de se lancer dans une adaptation libre, surtout pour une première contribution. ==== Modifier une page ==== Vous pouvez modifier n'importe quelle page simplement en cliquant sur le lien //Modifier cette page// dans le menu latéral (il n'est pas nécessaire d'être connecté pour cela, mais c'est une bonne pratique). N'hésitez pas à vous familiariser avec la [[wiki:syntaxe|syntaxe du wiki]] en faisant des essais sur la page [[wiki:bac_a_sable|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é//, enfin, cliquez sur le bouton //Enregistrer//. > [[doku>fr:editing|Pour aller plus loin..]] ==== Créer une page ==== Pour pouvoir créer une nouvelle page, il est nécessaire au préalable de [[https://forum.ubuntu-fr.org/register.php|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 [[wiki:modeles:utilisateur|créer votre page contributeur]] afin de vous présenter, rendez-vous sur l'url https://doc.ubuntu-fr.org/utilisateurs/MON_PSEUDO et cliquez sur le lien //Créer cette page//, le premier des boutons d'actions situés sur la droite. Pour créer une page dédiée à un logiciel, rendez-vous sur l'url https://doc.ubuntu-fr.org/nom_du_logiciel et faites de même. > [[doku>fr:page|Pour aller plus loin..]] ===== Bonnes pratiques ===== Voir aussi la page dédiée aux [[:wiki:recommandations|recommandations d'édition]]. En plus des règles déjà évoquées, un certain nombre de bonnes pratiques permettent de garantir la cohérence du wiki, ainsi que sa maintenabilité : ==== Contributeur ==== Les contributeurs et contributrices qui participent régulièrement au wiki sont invité·e·s à **se connecter** lorsqu'ils ou elles enregistrent une page. Les identifiants pour le wiki sont les mêmes que pour le [[https://forum.ubuntu-fr.org/|forum]]. Il est aussi recommandé d'échanger [[https://forum.ubuntu-fr.org/viewforum.php?id=208|forum]] avec les autres contributeurs et contributrices, demander conseil, apporter des précisions,.. Pensez par ailleurs à [[doku>fr:subscription|vous abonner aux pages]] que vous créez ou modifiez pour pouvoir en suivre les modifications et contrôler leur évolution. Enfin vous êtes invités à créer votre [[:wiki:modeles:utilisateur|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** : * Évitez l'emploi de la première personne, qui est trop 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é. * Évitez d'exprimer une opinion, ou d'établir des hiérarchisations à caractère personnel ("tel logiciel est nul, tel environnement est génial"). **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). Restez aussi simple que possible : les longues phrases alambiquées embrouillent inutilement, et découragent le lecteur, qui raterait ainsi des informations importantes : * **Allez au cœur du sujet** par des phrases simples et courtes. * Évitez les mots savants lorsqu'un synonyme plus courant peut faire l'affaire. * Évitez les anglicismes lorsqu'un mot existe déjà en français pour parler d'une notion. * **Commencez par la base** : expliquer en premier les notions les plus évidentes vous permettra de ne pas rebuter les lecteurs débutants. Vous trouverez davantage de recommandations éditoriales sur la [[:wiki:recommandations|page dédiée]]. ==== Syntaxe ==== Pour bien comprendre comment s'utilisent les balises du wiki, se référer à la page « [[:wiki:syntaxe|Syntaxe de mise en page]] », ainsi qu'à la [[doku>fr:wiki:syntax|documentation Dokuwiki]]. Un certain nombre de considérations sont à prendre en compte : * Pour que les pages restent lisibles sur les petits écrans, il faut éviter de mettre de très longues chaines de caractères (comme des liens http bruts). Utilisez plutôt 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 si possible suivre les [[wiki:modele|modèles]]. * Un certain nombre d'actions très courantes a fait l'objet de **[[wiki:mini-tutoriels|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. * Ne pas donner de commandes en [[:sudo|sudo]] : toute élévation des privilèges est potentiellement dangereuse, et même déconseillée par les développeurs dans le cas des applications graphiques, voire impossible sur certaines versions (notamment avec [[:Wayland]]). L'utilisation du mini-tutoriel adapté rend le wiki plus concis et plus simple à entretenir. * N'insérez pas d'images externes car cela complexifie les exports de la doc. Référez-vous au tutoriel « [[wiki:ajout_image|Ajouter une image dans votre document]] ». * Mettez absolument des [[wiki:tags| tags]] (mais n'en abusez pas non plus), car 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|administration]] sur une page qui explique comment administrer Ubuntu, mais pas sur les pages des logiciels qui ont besoin des droits d'administration. ===== Communiquer avec les autres contributeurs ===== Voir la page « [[:groupes:ubuntu-fr-doc|Groupe Ubuntu-fr documentation]] » pour mieux comprendre le fonctionnement de notre communauté. ==== Le salon de discussion ==== Nous avons opté pour un [[https://framateam.org/ubuntu/channels/doc|salon de chat framateam]]. Voici un [[https://framateam.org/signup_user_complete/?id=975ap86h5bfidyd6a6qhbes7ec|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 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 [[:mattermost_client|il existe des clients]] pour les systèmes d'exploitation et les mobiles les plus courants, Ubuntu y compris. {{:wiki-participer_wiki-mattermost-doc.png?400}} ===== Trucs et astuces ===== ==== Par où commencer ? ==== Vous pouvez commencer par corriger les fautes d'orthographe, restaurer les pages vandalisées, puis améliorer les pages des sujets que vous connaissez bien. Ensuite, votre aide sera appréciée notamment pour les appels à contribution qui apparaissent régulièrement sur le [[https://forum.ubuntu-fr.org/viewforum.php?id=208|forum]], et les [[:wiki:chantiers|chantiers en cours du wiki]] ! :-) ==== Pour aller plus loin... ==== Cette page, ainsi que les pages //[[:wiki:recommandations|Recommandations concernant le Wiki]]// et //[[:wiki:syntaxe|Syntaxe de mise en page]]// rappellent des généralités sur la rédaction d'un wiki, et développent les spécificités de notre wiki et de nos choix éditoriaux. Elles ne couvrent cependant pas toutes les possibilités de dokuwiki. N'hésitez pas à en consulter la [[doku>fr:wiki:syntax|documentation officielle]] pour creuser! Par exemple, il existe d'autres méthodes de [[doku>fr:page|création de page]] que celle présentée ici donc certaines vous paraîtront peut être plus intuitives. ----- * [[https://forum.ubuntu-fr.org/viewtopic.php?id=2093942|Discussion]] au sujet de cette page sur le forum.