Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
wiki:participer_wiki [Le 01/09/2015, 19:35]
0ol [Participer activement à la documentation]
wiki:participer_wiki [Le 24/01/2022, 18:14] (Version actuelle)
hibou7 [Créer une page]
Ligne 2: Ligne 2:
  
 ---- ----
 +
 ====== Comment participer et améliorer cette documentation ? ===== ====== Comment participer et améliorer cette documentation ? =====
  
-La [[:​|documentation ​du site Ubuntu-fr]] est publiée sous forme de [[wpfr>​wiki]],​ un système de rédaction ouvert et collaboratif ​que **chacun est libre de modifier**. Elle est la principale source d'​information francophone concernant Ubuntu et les logiciels libres. Si vous êtes un bon pédagogue, aidez à l'​améliorer ​en écrivanten complétant,​ en corrigeant ou en traduisant des articles.\\ +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 talentsqu'il s'​agisse de créer ​une nouvelle pagede mettre ​à jour des pages existantes, de simplifier, corrigerou mettre en conformité avec nos normes rédactionnelles.
-Tout le monde peut y participer : la modification((La création d'un nouvel article requiert ​une petite inscriptionmais la modification d'​articles déjà existants est ouverte ​à toutes et à tousmise à part la page d'​accueil.)) d'​articles ne nécessite pas d'​inscription.\\ +
-Que vous souhaitiez commencer un texte à partir ​de rien, corriger ​des « fôts daurthograf » ou simplifier des phrases, **votre contribution est la bienvenue**.+
  
-<​note ​tip>A titre d'aide mémoire, consultez ​la [[wiki:checklist|Checklist du contributeur]], qui reprend rapidement l'​ensemble des bonnes pratiques.+Merci d'​avance pour vos contributions ! 
 +<​note>​Pour connaître ​d'autres façons de contribuer à Ubuntu, consultez ​ [[:comment_participer|cette page]].</​note>​
  
-Pour connaître toutes les façons de contribuer à Ubuntu, consultez ​ [[:​comment_participer|cette page]].</​note>​+===== Les règles du wiki =====
  
-===== L'état d'esprit : comment contribuer efficacement ?​ =====+Pour pouvoir contribuer de manière efficace, il est utile de se coordonner avec les autres contributeurs. Deux outils sont mis à disposition dans ce but : une [[#​la_liste_de_diffusion|liste de diffusion]] par email, et un [[#​le_salon_de_discussion|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 ​d'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.
  
-Voici différentes façons ​de présenter à titre indicatif les bases éthiques sur lesquelles reposent les mécanismes techniques du site ubuntu-fr.org et plus précisément ​de cette documentation ​:+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]]).
  
-  * Un [[:​codedeconduite|code ​de conduite]] (issu du site anglais) est induit par les principes d'​Ubuntu ​qui se rattachent notamment à la philosophie du même nom (voir aussi l'​article « [[wpfr>​Ubuntu (idéologie)]] » sur Wikipédia ​et une [[http://​upload.wikimedia.org/​wikipedia/​commons/​0/​0c/​Experience_ubuntu.ogg|vidéo représentant ce concept]]). +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 similaireafin que le lecteur ne soit pas perdu en passant de l'une à l'autre.
-  * Il ressort également de l'​expérience commune quelques principes élémentaires relatifs ​à la documentation sous forme wiki : +
-    ​* **Rester aussi simple que possible** : cette notice a comme ambition de pouvoir s'​adresser à tous. +
-    * **Distinguer les faits** : ce sont eux qui vont aider l'​utilisateur. Un choix, une préférence ou une recommandation sont du domaine des avis. Pour obtenir ​un fait, il faut préciser selon qui. +
-    * **Commencer par la base** : ce qui est évident est important. C'est la première marche indispensable pour les plus novices mais aussi ce qui permet d'​organiser facilement les choses plus complexes. +
-  * Cette documentation peut aussi être représentée par des métaphores (pour imager autrement les principes précédents) :  +
-      * c'est un //pense bête communautaire//​ : il doit permettre à chacun ​de retrouver ce qui est utile pour luisans gêner ce qui est utile pour les autres ; +
-      * c'est aussi un //bagage pour un voyage vers l'inconnu// : les choses les plus utiles doivent rester les plus accessibles,​ mais il faut aussi prévoir de faire face à des situations qu'on ne connaît pas encore. +
-  * Utiliser les modèles, suivre les conseils de cette page et respecter la [[:​wiki:​ligne_editoriale|ligne éditoriale de la documentation]] !+
  
 +<note help>Ne vous sentez pas bloqués par le grand nombre de bonnes pratiques : ces recommandations simplifient le fonctionnement du wiki, vous les apprendrez petit à petit, et les autres contributeurs "​rectifieront le tir" si c'est vraiment nécessaire grâce à la liste de diffusion par email.</​note>​
  
-===== Aider ou améliorer une documentation ​=====+===== Apprendre à créer et à modifier des pages =====
  
-[[:​evenements:​2006_11_18_reunion_association_cr|La réunion 2006 no. 3]] a déterminé ​la procédure ​de modification ​des pages existantes. Il a donc été décidé d'​autoriser l'​accès en écriture aux documentations,​ leur modification immédiate est autorisée, en parallèle l'​abonnement des pages rendu possible avertit immédiatement de toutes les modifications des pages auxquelles certains contributeurs sont inscrits.+<note important>​Merci de prévenir les autres contributeurs via la liste de diffusion ou le salon de discussion pour toute création de page et pour toute modification ​majeure.</​note>​
  
-La documentation d'​Ubuntu-fr n'est peut-être pas toujours tout à fait claire, et c'est bien normal. Elle est en constante évolution et rédigée sur une base volontaire. La meilleure façon de la voir devenir meilleure est de la critiquer (de manière constructive) et d'​informer de ses observations !+==== Les modèles ====
  
-==== Participer activement à la documentation ==== +Afin de garantir l'homogénéité ​du wiki, essayezpour chaque ​page créée ou éditée, de conformer si possible ​vos contributions à l'un des modèles proposés :  
- +  * pour parler ​d'un logicielle modèle [[wiki:​modeles:​application|Application]] ; 
-Les plus téméraires voudront peut-être aussi s'abonner à la [[:​wiki:​liste_discussion#​coordination_wiki|liste de diffusion des contributeurs du wiki]] //​(Coordination Wiki)//. Ils pourront ainsi discuter par courriel avec plusieurs contributeurs ​du wiki, leur présenter quels articles ils jugent difficiles et qui mériteraient une refonte. Breftravailler en coopération avec ceux-là mêmes qui rédigent la documentation ! +  * pour présenter un ordinateur, le modèle ​[[wiki:modeles:portable|Portable]] 
- +  * pour présenter ​un périphérique, le modèle ​[[wiki:modeles:​materiel|Matériel]] 
-=== Contacter l'​auteur d'une documentation === +  * 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]] ; 
-À défaut de modifier la page concernéevous pouvez toujours faire part de vos critiques directement aux contributeurs. Ainsi beaucoup ​d'articles sont signés par leur(s) auteur(s)en bas d'​article ​ (voir la [[:utilisateurs:liste|liste des utilisateurs]]). Vous pouvez donc cliquer dessus ​pour accéder à leur page utilisateur pour avoir des renseignements sur la façon de les contacter. Ainsi, n'​oubliez pas d'​expliquer quelle page devrait être retravaillée dans telle section car ceci ou cela est obscur et de dire en quoi cela est obscur, c'​est ​un moyen efficace pour voir ses remarques prises en compte et de voir apporter des modifications à l'​article. +  * pour vous présenter sur le wikile modèle ​[[wiki:modeles:​utilisateur|Utilisateur]]. 
- +Si la page que vous projetez ne cadre pas avec l'un des modèles proposésil vaut mieux poser la question ​aux autres contributeurs que de se lancer ​dans une adaptation libresurtout ​pour une première ​contribution. ​
-=== S'​abonner à une page === +
- +
-Si une page vous intéresse que vous souhaitez suivre dans son évolution ou simplement surveiller contre le vandalismevous pouvez vous y abonner.  +
-Il vous faut au préalable être inscrit sur le [[http://​forum.ubuntu-fr.org/​|forum Ubuntu]] puis se connecter sur la [[:accueil|documentation]] avec le même identifiant. +
-Vous pourrez alors [[#​s_abonner_aux_modifications|gérer vos souscriptions]]. +
- +
- +
-=== Utiliser ​le forum === +
- +
-Enfinil est toujours possible de [[http://​forum.ubuntu-fr.org|créer un fil de discussion dans le forum]] à propos d'un article précisQuelques-uns des contributeurs au wiki passent aussi dans le forum, mais pas tous. Néanmoins, un fil de discussion aura le mérite d'​attirer ​l'attention de personnes moins dégourdies en matière d'​Ubuntude celles-là mêmes qui vont utiliser le wiki qui pourront réagir ​aux propositions,​ et peut-être aussi de futurs contributeurs ? Mais comme nous l'​avons mentionné, tous les contributeurs ne passent pas dans le forumdonc il faudra aussi penser à les contacter ​pour qu'ils puissent appliquer les modifications nécessaires si personne d'​autre ne s'en charge.((Si quelqu'​un apporte directement ​une contribution, elle devra alors suivre [[:​wiki:​participer_wiki|les instructions données aux contributeurs]].))+
  
 ==== Modifier une page ==== ==== Modifier une page ====
  
-Il suffit de cliquer ​sur « **Modifier cette page** » (dans l'encart ​//Actions// en haut à gauche) ​pour avoir la possibilité de modifier ​une page existante.+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//​.
  
-Le bouton « **Aperçu** » permet de visualiser les changements et permet de les retrouver (depuis son ordinateur seulement si pas connecté, sinon depuis tous les ordinateurs)Il est nécessaire de faire un aperçu avant de pouvoir enregistrer.+> [[doku>​fr:​editing|Pour aller plus loin..]]
  
-Le bouton « **Enregistrer** » sauve la modification (sur le serveur) et la rend accessible à tous.+==== Créer une page ====
  
-Pour se familiariser avec ce système, la page [[bac à sable]] permet ​de faire des essais sans aucun risque.+Pour pouvoir créer une nouvelle pageil 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.
  
-Remarque ​pour effacer une page, il suffit de modifier la page, la vider de son contenu, puis de sauvegarderNe pas oublier de mettre en commentaire la raison pour laquelle vous avez supprimé la page.+> [[doku>​fr:page|Pour aller plus loin..]]
  
-==== Trois types de modifications ​====+===== Bonnes pratiques =====
  
-Toutes les modifications que vous apporterez à la documentation font partie d'​un ​des trois types ci-dessous.+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é :
  
-=== Modifications légères ​===+==== Contributeur ====
  
-Pour corriger des fautes d'​orthographe,​ des liens ou toute autre coquille et, d'​une ​manière générale, ​pour les améliorations de la forme plutôt ​que du fond, le fait de remplir ​la section « Résumé » en bas de la zone de modification permet de décrire rapidement ​le genre de contribution à l'intention des autres contributeurs.+Les contributeurs qui participent régulièrement au wiki sont invités à **se connecter** lorsqu'ils enregistrent ​une page. Les identifiants ​pour le wiki sont les mêmes ​que pour le [[https://​forum.ubuntu-fr.org/​|forum]]. Cela facilite énormément ​le travail des administrateurs et c'est plus convivial. Il est aussi recommandé ​de **s'​inscrire sur la mailing liste et le salon de discussion** afin d'échanger avec les autres contributeurs, demander conseil, apporter des précisions,​.
  
-Cette pratique est appréciée car elle facilite grandement l'​utilisation de l'​historique.+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.
  
-=== Interventions importantes ===+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. ​
  
-En cas de refonte d'​articles,​ d'​ajout ou de suppression de passages ou plus généralement de modifications changeant grandement le sens du document, l'​équipe qui gère cette documentation souhaite en être informée par l'​intermédiaire de [[wiki:​liste_discussion|la liste de discussion de la documentation]]. Ce type d'​envoi nécessite une inscription préalable [[https://​eshu.ubuntu-eu.org/​cgi-bin/​mailman/​listinfo/​ubuntu_wiki-fr|sur son portail]]. +==== Rédaction ====
-Cela permet aux utilisateurs de cette liste d'​intervenir plus rapidement pour ajouter les logiques d'​uniformisation,​ pour corriger les éventuelles erreurs, etc.+
  
-=== Créations ​de nouvelles pages ===+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).
  
-Pour pouvoir [[:wiki:​participer_wiki#​comment_creer_une_page_dans_la_documentation|créer une page]]il est préférable d'​être connecté en tant que membre de ce site (il s'agit du même compte que pour le forum, pour s'​inscrire, c'est [[http://​forum.ubuntu-fr.org/​register.php|ici]]). Comme c'est aussi une intervention importante, ​l'équipe qui gère le wiki souhaite également ​en être informée ​par l'​intermédiaire de [[wiki:liste_discussion|la liste de discussion de la documentation]],​ d'​autres contributeurs ​plus expérimentés ​vous aideront à finaliser la page.+Restez aussi simple que possible ​les longues phrases alambiquées embrouillent inutilementet découragent ​le lecteurqui 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.
  
-===== Comment créer une page dans la documentation ?​ =====+==== Syntaxe ​====
  
-{{ tutoriel:creer-page.png}}+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]].
  
-Pour créer une page dans la documentation,​ vous devez être connecté ​en tant que membre ​de ce siteIl s'​agit ​du même compte que pour le forum, si vous n'en avez pasvous pouvez ​en créer ​un [[http://forum.ubuntu-fr.org/​register.php|ici]].+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 wikiil 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 docRé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.
  
-Une fois connecté, allez à l'​adresse que vous souhaiteriez pour votre future page, par exemple : http://​doc.ubuntu-fr.org/​Nom_de_la_page+===== Communiquer avec les autres contributeurs =====
  
-Si cette page n'​existe pas encore, l'​option « **Créer cette page** » apparaît dans l'​onglet **Actions**,​ sur la gaucheCliquez dessus et c'est parti !+<note help>​Voir la page « [[:​groupes:​ubuntu-fr-doc|Groupe Ubuntu-fr documentation]] ​» pour mieux comprendre le fonctionnement de notre communauté.</​note>​
  
-==== Les modèles à suivre ​====+==== La liste de diffusion ​====
  
-En cas de création d'une page, veuillez choisir l'un des modèles standardisés ci-dessous : +Une [[wpfr>​Liste_de_diffusion|liste de diffusion]] permet à toutes les personnes qui s'y sont inscrites de recevoir les mails que l'une d'entre elles y envoieAu niveau ​de la documentation ​Ubuntu, cela représente une dizaine de courriels par semaine environ. Il ne faut donc pas avoir peur d'être envahi.
-  * **[[wiki:​modeles:​application|Modèle ​de page « application »]]** : pour présenter l'installation et l'utilisation ​d'un logiciel sous Ubuntu +
-  * **[[wiki:​modeles:​materiel|Modèle ​de page « matériel »]]** : pour expliquer comment faire fonctionner un matériel particulier sous Ubuntu. Il existe un modèle spécifique pour les ordinateurs portables (ci-dessous).  +
-  * **[[wiki:​modeles:​portable|Modèle de page « portable »]]** : pour expliquer comment faire fonctionner un ordinateur portable sous Ubuntu. +
-  * **[[wiki:​modeles:​tutoriel|Modèle de page « tutoriel »]]** : pour expliquer ​pas-à-pas comment résoudre une problématique (en utilisant généralement plusieurs applications).  +
-  * **[[:​wiki:​modeles:​portail|Modèle de page « portail »]]** : pour lister les tutoriels et logiciels Ubuntu ​d'un thème précis. +
-  * **[[wiki:​modeles:​utilisateur|Modèle de page « utilisateur »]]** : espace personnel pour se présenter+
  
 +<note tip>De nos jours les clients mails permettent de classer ces courriels dans un dossier spécifique avec délestage régulier si nécessaire.</​note> ​
  
 +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és, et filtrer comme bon vous semble.\\
 +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 facile avec les applications de messagerie instantanée.
  
 +Pour toutes ces raisons notre [[wiki:​liste_discussion#​coordination_de_la_documentation|liste de diffusion]] reste l'​outil principal de collaboration autour du wiki. Voici le **[[https://​listes.ubuntu-fr.org/​subscribe/​ubuntu_wiki-fr|lien d'​inscription]]**.
  
-===== Les bonnes pratiques ===== +<note tip>Ne commettez pas l'​erreur ​de vous croire trop inexpérimenté ​pour participer ​car tous les profils sont présents, et tous sont bienvenus ;).</note>
- +
-====Se connecter au wiki==== +
- +
-Pour pouvoir être contacté au sujet des modifications que vous apportez au wiki (généralement pour des conseils, ou en cas d'​erreur ​dans la modification que vous apportez), il est préférable d'​être connecté en tant que membre de ce site (il s'agit du même compte que pour le forum, pour s'​inscrire,​ c'est [[http://​forum.ubuntu-fr.org/​register.php|ici]]).  +
- +
- +
-==== Créer une page utilisateur ==== +
- +
-Si vous comptez ​participer ​régulièrement au wiki, vous êtes invités à [[:​wiki:​modeles:​utilisateur|créer une page utilisateur]]. Vous pourrez vous présenter et donner un moyen de vous contacter. +
-Si vous avez besoin de créer une page temporaire, vous pourrez la placer dans votre répertoire ainsi créé. +
- +
- +
-==== Les pages de tests ==== +
- +
-Faites vos essais dans le [[playground:​playground|bac à sable]]. +
- +
-==== Indiquer les sources ==== +
- +
-Si vous avez l'​intention de recopier ou traduire un article ou une partie d'​article d'un autre site vérifiez certains points : +
- +
-   * Il est nécessaire de vérifier la licence sous laquelle cet article est placé et en conséquence si elle vous autorise à l'​utiliser. À défaut contacter l'​auteur par un petit courriel. +
-   * Il vous faudra indiquer la licence elle-même, la provenance et l'​auteur de l'​article original.  +
- +
-Sinon : +
-    * Si la licence ne le permet pas, la modification sera illégale et sera donc supprimée rapidement. +
- +
-Dans tous les cas, avertissez l'​auteur de l'​article en question. +
- +
-==== Éviter les éditions répétées ==== +
- +
-Lorsque vous enregistrez une modification (via le bouton **Enregistrer**),​ une entrée est créée dans l'​historique de la page (la section ​ "​Anciennes révisions"​ de la page) et un mail est envoyé aux administrateurs du wiki ainsi qu'aux membres qui suivent la page.  +
- +
-Pour ces raisons évitez l'​utilisation répétée du bouton **Enregistrer**. Tant que vous n'avez pas fini vos modifications sur une page, utilisez plutôt le bouton **Aperçu** (crée un brouillon récupérable sans difficulté en cas de besoin), ou bien : un fichier texte, le bac à sable ou votre espace utilisateur. +
- +
-==== Utiliser les tags modérément ==== +
- +
-Chaque page doit être référencée avec au moins un tag (mot-clé). Mais n'en abusez pas : trop de tags est contre-productif. Inspirez-vous des tags présents ​dans les [[:​wiki:​participer_wiki#​les_modeles_a_suivre|modèles]]. +
- +
-Pour plus d'​informations sur les tags consultez la [[:​wiki:​tags| page de documentation consacrée aux tags]]. +
- +
-====Insérer des images ==== +
- +
-Afin d'​alléger la documentationil est demandé aux contributeurs de ne pas insérer d'​images trop grandes. +
- +
-Voir le tutoriel "​[[wiki:​ajout_image|Ajouter des images dans le wiki]]"​. +
- +
-==== Utiliser les mini-tutoriels ==== +
- +
-Afin d'​alléger la documentation,​ il est demandé aux contributeurs de ne pas expliciter directement dans la page certaines actions souvent invoquées. À la place, il est renvoyé à des « mini-tutoriels » grâce à des liens. La liste des actions en question ​et les liens à utiliser ​sont explicités dans les sections suivantes. +
- +
-**Voir [[:​wiki/​mini-tutoriels|Mini-tutoriels]]** +
- +
-==== Respecter le code de conduite ==== +
- +
-Comme dans tout ce qui a trait à Ubuntu, inspirez-vous de son [[:​codedeconduite|code de conduite]]. +
- +
-==== Respecter la ligne éditoriale de la documentation ==== +
- +
-Tout contenu ajouté au wiki ubuntu-fr doit suivre les règles et objectifs fixés dans la [[:​wiki:​ligne_editoriale|ligne éditoriale de la documentation]]. +
- +
-==== S'​abonner aux modifications ==== +
- +
-Si vous maitrisez bien le sujet d'une page, abonnez-vous aux modifications de cette page afin de vérifier qu'​aucune erreur ne s'y glissera. Pour cela vous devez avoir un compte utilisateur (il s'agit du même compte que pour le forum, pour s'​inscrire,​ c'est [[http://​forum.ubuntu-fr.org/​register.php|ici]]). +
- +
-Pour cela, cliquez sur le bouton ​//​S'​abonner à la page// dans le menu //Actions// à gauche. Vous arrivez alors sur la page de //Gestion de l'​abonnement//​. Choisissez ensuite si vous voulez vous abonner à cette page seulement (nom de la page), ou au dossier dans lequel se trouve cette page (*). Cliquez finalement sur //​Souscrire//​. Par la suite, vous recevrez par courrier électronique un résumé des modifications effectuées sur la(les) page(s) en question. +
- +
-Pour se désabonner d'une page, procédez de la même manière que pour l'​abonnement. Une fois rendu sur la page //Gestion de l'​abonnement//,​ cliquez sur //Annuler la souscription//​ dans la section //​Souscriptions actives//​. +
- +
-==== La checklist du contributeur ==== +
- +
-Si vous n'avez pas le temps de relire tous les guides de bonnes pratiques de rédaction à chaque fois que vous effectuez une modification du wiki, consultez au minimum la [[wiki:​checklist|Checklist du contributeur]]. Cette liste synthétique reprend en 10 points l'​essentiel des choses à vérifier pour être sûr d'​être en harmonie avec le reste de la doc. +
- +
-===== C'est parti ! ===== +
- +
-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 **[[:​wiki:​chantiers|chantiers en cours du wiki]]**, et les **appels à contributions qui apparaissent régulièrement sur la [[:​wiki:​liste_discussion|mailing-list du wiki]]** !  :-)  +
- +
- +
- +
- +
- +
-===== Communiquer avec les autres contributeurs =====+
  
-==== Les administrateurs ​====+==== Le salon de discussion ​====
  
-En cas de doute ou de problème : contactez ​les [[:groupes/ubuntu-fr-doc#​administrateurs|administrateurs]] du wiki.+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 [[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.
  
-==== La liste de discussion ====+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 [[:​mattermost_client|il existe des clients]] pour les systèmes d'​exploitation et les mobiles les plus courants, Ubuntu y compris. Le fait de devoir s'​inscrire constitue une contrainte supplémentaire par rapport à IRC, 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é.
  
-Une **liste de discussion** (appelée également mailing-list en anglais) ​est disponible ​pour les contributeurs du wiki. +<​note>​Un navigateur récent ​est requis ​pour pouvoir accéder au client web (Firefox 52+Chrome 43+)</​note>​
-Elle permet de recevoir et de participer aux discussions en rapport avec le wiki. Nous vous recommandons de vous y inscrirenotamment pour y annoncer vos modifications importantes. C'est le meilleur moyen pour avoir des retours sur vos modifications.+
  
-Vous trouverez [[wiki:​liste_discussion#​coordination_de_la_documentation|à cet endroit]] les adresses d'​inscription à la liste de discussion du wiki. Ainsi que des informations plus globales sur [[wiki:​liste_discussion| l'​ensemble de la page]].+===== Trucs et astuces =====
  
-==== Le chan de discussion ​====+==== 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 la [[:​wiki:​liste_discussion|mailing-list du wiki]], et les [[:​wiki:​chantiers|chantiers en cours du wiki]] !  :-) 
  
-Vous pouvez également discuter avec les contributeurs du wiki sur le chan : **#​ubuntu-fr-doc** +==== Pour aller plus loin... ====
-Si vous ne disposez pas de client IRC vous pouvez vous rendre sur [[http://​www.ubuntu-fr.org/​webchat|cette page.]] Il vous suffit ensuite d'​entrer un pseudo dans le champ //​Nickname//​ puis **#​ubuntu-fr-doc** dans le champ //​Channels//​ pour accéder au salon de discussion.+
  
-===== Voir aussi =====+Cette page, ainsi que la page [[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. Cependant elles ne couvrent pas toutes les possibilités de dokuwiki. N'​hésitez pas à en consulter la [[doku>​fr:​syntax|documentation officielle]] pour creuser! Par exemple, il existe d'​autres méthodes de [[doku>​fr%3Apage|création de page]] que celle présentée ici donc certaines vous paraîtront peut être plus intuitives.
  
-  * Pour rédiger des articles, on utilise la syntaxe DokuWiki : [[wiki:​syntaxe|voir la syntaxe]] ([[doku>​fr:​syntax|page dokuwiki expliquant la syntaxe]]). 
  
  • wiki/participer_wiki.1441128904.txt.gz
  • Dernière modification: Le 01/09/2015, 19:35
  • par 0ol