Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
wiki:participer_wiki [Le 24/05/2010, 09:48] YannUbuntu ajout draco et email de contact |
wiki:participer_wiki [Le 20/06/2023, 13:56] (Version actuelle) bcag2 inversion ordre affichage liste diff / salon de discussion |
||
|---|---|---|---|
| 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 française concernant Ubuntu. Si vous êtes un bon pédagogue, aidez à l'améliorer en écrivant, en 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 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. |
| - | Tout le monde peut y participer : la modification((La création d'un nouvel article requiert une petite inscription, mais la modification d'articles déjà existants est ouverte à toutes et à tous, mise à 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>Pour connaitre toutes les façons de contribuer à Ubuntu, consultez [[:comment_participer|cette page]].</note> | + | Merci d'avance pour vos contributions ! |
| + | <note>Pour connaître d'autres façons de contribuer à Ubuntu, consultez [[:comment_participer|cette page]].</note> | ||
| - | ===== L’état d'esprit : comment contribuer efficacement ? ===== | + | ===== Les règles du wiki ===== |
| - | 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 : | + | 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. | ||
| - | * 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]], également présente dans la distribution Ubuntu). | + | Aussi, il y a des règles de bon sens auxquelles il est demandé de se conformer : |
| - | * Il ressort également de l'expérience commune quelques principes élémentaires relatifs à la documentation sous forme wiki : | + | * Se limiter au contenu tourné vers Ubuntu ([[wiki:ligne_editoriale|ligne éditoriale]]) ; |
| - | * **Rester aussi simple que possible** : cette notice a comme ambition de pouvoir s'adresser à tous. | + | * Respecter la législation française ([[wiki:ligne_ethique|ligne éthique]]) |
| - | * **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. | + | * Respecter les contributions pertinentes des autres utilisateurs ([[:codedeconduite|code de conduite]]). |
| - | * **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 lui, sans 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 et suivre les conseils de cette page ! | + | |
| + | 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 que le lecteur ne soit pas perdu en passant de l'une à l'autre. | ||
| - | ===== Aider ou améliorer une 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> |
| - | [[:evenements:reunion3_2006_compte_rendu|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. | + | ===== Apprendre à créer et à modifier des pages ===== |
| - | 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 ! | + | <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> |
| - | ==== Participer activement à la documentation ==== | + | ==== Les modèles ==== |
| - | 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. Bref, travailler en coopération avec ceux-là mêmes qui rédigent la documentation ! | + | 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]] ; | |
| - | === Contacter l’auteur d’une 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]] ; | |
| - | À défaut de modifier la page concernée, vous 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 apportées des modifications à l'article. | + | * 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]] ; | |
| - | === S’abonner à une page === | + | * 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 que de se lancer dans une adaptation libre, surtout pour une première contribution. | |
| - | Si une page vous intéresse que vous souhaitez suivre dans son évolution ou simplement surveiller contre le vandalisme, vous pouvez vous y abonner. Il faut cependant être inscrit sur le [[http://forum.ubuntu-fr.org/|forum Ubuntu]] puis se connecter sur la [[:accueil|documentation]] avec le même identifiant. | + | |
| - | + | ||
| - | == Se désabonner == | + | |
| - | + | ||
| - | Pour vous désabonner, rendez-vous sur la page ou la catégorie à laquelle vous êtes abonné et cliquez sur « **Se désabonner de la page** » ou « **Se désabonner de la catégorie** ». | + | |
| - | + | ||
| - | === Utiliser le forum === | + | |
| - | + | ||
| - | Enfin, il est toujours possible de [[http://forum.ubuntu-fr.org|créer un fil de discussion dans le forum]] à propos d'un article précis. Quelques-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'Ubuntu, de 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 forum, donc 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 « **Éditer 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. | + | |
| - | + | ||
| - | Le bouton « **Enregistrer** » sauve la modification (sur le serveur) et la rend accessible à tous. | + | |
| - | + | ||
| - | Pour se familiariser avec ce système, la page [[bac à sable]] permet de faire des essais sans aucun risque. | + | |
| - | + | ||
| - | ==== Trois types de modifications ==== | + | |
| - | + | ||
| - | Toutes les modifications que vous apporterez à la documentation font partie d'un des trois types ci-dessous. | + | |
| - | + | ||
| - | === Modifications légères === | + | |
| - | + | ||
| - | 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. | + | |
| - | + | ||
| - | Cette pratique est appréciée car elle facilite grandement l'utilisation de l'historique. | + | |
| - | + | ||
| - | === Interventions importantes === | + | |
| - | + | ||
| - | 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 la [[wiki:liste_discussion|la liste de discussion de la documentation]]. Ce type d'envoi nécessite une inscription préalable [[http://eshu.ubuntu-eu.org/mailman/listinfo/ubuntu_wiki-fr|sur son portail]]. | + | |
| - | 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 === | + | |
| - | + | ||
| - | 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. | + | |
| - | + | ||
| - | ===== Comment créer une page dans la documentation ? ===== | + | |
| - | + | ||
| - | {{ tutoriel:comment_creer_une_page_hardy.png?121x171}} | + | |
| - | + | ||
| - | Pour créer une page dans la documentation, vous devez être de préférence connecté en tant que membre de ce site. Il s'agit du même compte que pour le forum, si vous n'en avez pas, vous pouvez en créer un [[http://forum.ubuntu-fr.org/register.php|ici]]. | + | |
| - | + | ||
| - | Une fois connecté, allez à l'adresse que vous souhaiteriez pour votre future page, par exemple : http://doc.ubuntu-fr.org/ma_page | + | |
| - | + | ||
| - | Si cette page n'existe pas encore, l'option « **Créer cette page** » apparaît dans l'onglet **Actions**, sur la gauche. Cliquez dessus et c'est parti ! | + | |
| - | + | ||
| - | ==== Trois types de pages ==== | + | |
| - | + | ||
| - | En cas de création d'une page, il existe des modèles standardisés, veuillez vous y référer. | + | |
| - | + | ||
| - | Il existe essentiellement trois types d'articles sur le wiki, détaillés ci-dessous. | + | |
| - | + | ||
| - | === Application === | + | |
| - | + | ||
| - | Leur but est d'expliquer et présenter une application, un logiciel (software). Il existe [[wiki:modeles:application|un modèle]] pour ce type d'articles. Les pages application sont placées à **la racine** du wiki. | + | |
| - | + | ||
| - | → [[wiki:modeles:application|Modèle « application »]] | + | |
| - | + | ||
| - | === Matériel === | + | |
| - | + | ||
| - | Leur but est d'expliquer comment faire fonctionner un matériel particulier sous Ubuntu. Il existe [[wiki:modeles:materiel|un modèle]] pour ce type d'articles ainsi qu'un modèle spécifique pour les [[wiki:modeles:portable|portables]]. Veillez à être le plus généraliste possible (par exemple, un modem PPPoE s'installe de la même manière pour tous les fournisseurs d'accès : il n'est pas nécessaire d'écrire une nouvelle page pour Free, Skynet, Alice, etc.). Les pages matériel doivent comporter le tag « matériel » et sont placées à **la racine** du wiki. | + | |
| - | + | ||
| - | → [[wiki:modeles:materiel|Modèle « matériel »]] | + | |
| - | + | ||
| - | → [[wiki:modeles:portable|Modèle « portable »]] | + | |
| - | + | ||
| - | + | ||
| - | === Tutoriel === | + | |
| - | + | ||
| - | Ils se proposent de résoudre une problématique et utilisent généralement plusieurs applications (exemple : [[tutoriel:comment_compiler_un_kernel_sur_mesure|Comment compiler un noyau sur mesure ?]]). Les tutoriels n'ont pas vraiment de modèle ; veillez cependant à mentionner les versions d'Ubuntu pour lesquelles il est écrit. Les tutoriels doivent comporter le tag « tutoriel » et sont placés dans le **sous-dossier « tutoriel »**. | + | |
| - | + | ||
| - | ===== Utilisation de 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/syntaxe#mini-tutoriels|Syntaxe]]** | + | |
| - | ===== Les bonnes pratiques ===== | + | > [[doku>fr:editing|Pour aller plus loin..]] |
| + | ==== Créer une page ==== | ||
| - | ==== Créer une page utilisateur ==== | + | 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. | ||
| - | 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. | + | > [[doku>fr:page|Pour aller plus loin..]] |
| - | Si vous aviez besoin de créer une page temporaire, vous pourriez la placer dans votre répertoire ainsi créé. | + | |
| - | ==== Les pages de tests ==== | + | ===== Bonnes pratiques ===== |
| - | Faites vos essais dans le [[playground:playground|bac à sable]]. | + | 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é : |
| - | ==== Les sources ==== | + | ==== Contributeur ==== |
| - | Si vous avez l'intention de recopier ou traduire un article ou une partie d'article d'un autre site vérifier certains points : | + | 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,.. |
| - | * 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. | + | 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. |
| - | * Il vous faudra indiquer la licence elle-même, la provenance et l'auteur de l'article original. | + | |
| - | Sinon : | + | 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. |
| - | * Si la licence ne le permet pas la modification sera illégale, et sera donc supprimé rapidement. | + | |
| - | Dans tous les cas, avertissez l'auteur de l'article en question. | + | ==== Rédaction ==== |
| - | ==== Utilisez le bouton « Aperçu » ==== | + | 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). | ||
| - | Lorsque vous éditez une page, l'utilisation du bouton **Aperçu** permet de sauver régulièrement les modifications apportées et évite de les perdre en cas de plantage sans avoir recours au bouton **Sauver**. Il crée un brouillon récupérable sans difficulté en cas de besoin. | + | 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. | ||
| - | De plus, de trop nombreuses sauvegardes surchargent la page « Anciennes révisions » de chaque page et la boîte aux lettres de ceux qui reçoivent un courriel à chaque sauvegarde (ceux qui sont abonnés aux modifications). | + | ==== Syntaxe ==== |
| - | ==== Utiliser les tags modérément ==== | + | 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]]. |
| - | 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 modèles de pages [[:wiki:modeles:application]] et [[:wiki:modeles:matériel]] et essayez de vous limiter à ceux déjà existants (voir la [[:categories|liste des tags]]). Et n'oubliez pas que la règle, c'est de mettre les accents dans les //tags// au singulier (mat**é**riel et non mat**e**riel**s** par exemple). | + | 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. | ||
| - | ==== Respectez le code de conduite ==== | + | ===== Communiquer avec les autres contributeurs ===== |
| - | Comme dans tout ce qui a trait à Ubuntu, inspirez-vous de son [[:codedeconduite|code de conduite]]. | + | <note help>Voir la page « [[:groupes:ubuntu-fr-doc|Groupe Ubuntu-fr documentation]] » pour mieux comprendre le fonctionnement de notre communauté.</note> |
| - | ==== S'abonner aux modifications ==== | + | ==== Le salon de discussion ==== |
| - | Chaque contributeur principal d'une page devrait s'abonner aux modifications de cette page afin de les suivre. | + | 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. | ||
| - | Pour cela, il suffit de cliquer sur le bouton « S'abonner à la page » dans le menu « Actions » à gauche. L'abonné recevra alors par courrier électronique un résumé des modifications effectuées sur la page en question. | + | 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|}} | ||
| - | ===== C'est parti ! ===== | + | ==== La liste de diffusion ==== |
| - | **Vous pouvez commencer par modifier certaines pages, notamment sur la page des [[:wiki:chantiers|chantiers en cours]] pour ceux qui veulent aider mais qui sont en manque d'inspiration. | + | 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 envoie. Au 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. |
| - | ** | + | |
| - | Vous pouvez aussi vous amuser sur la page [[playground:playground|playground]], littéralement la //salle de jeu//, avec des exemples de mise en forme. | + | <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> |
| - | Ou alors aider les [[:ubuntu-l10n-fr:aide_a_la_traduction|aides à la traduction]]. | + | 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 adresses utiles ===== | + | <note tip>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 ;).</note> |
| - | ==== Les coordinateurs ==== | + | ===== Trucs et astuces ===== |
| - | En cas de doute, en cas de problème : contactez les coordinateurs du wiki ([[utilisateurs:Ner0lph]], [[utilisateurs:YoBoY]], [[utilisateurs:YannUbuntu]] et [[utilisateurs:draco31.fr]]). | + | ==== Par où commencer ? ==== |
| - | Ils sont accessibles par courriel à l'adresse suivante : **ubuntu-fr-doc [AROBASE] lists.launchpad.net** | + | 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]] ! :-) |
| - | ==== La liste de discussion ==== | + | ==== Pour aller plus loin... ==== |
| - | Une liste de discussion (appelée également mailing-list en anglais) est disponible pour les contributeurs du wiki. Il est recommandé de s'y inscrire et d'y annoncer ses modifications importantes. | + | 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. |
| - | [[wiki:liste_discussion|Plus d'informations sur cette page]]. | ||
| - | ==== Autres adresses ==== | ||
| - | * Pour rédiger des articles, on utilise la syntaxe DokuWiki : [[wiki:syntaxe|voir la syntaxe]]. ([[http://www.dokuwiki.org/fr:syntax|page dokuwiki expliquant la syntaxe]]) | ||
| - | * Les modèles : [[wiki:modeles:application|application]],[[wiki:modeles:materiel|matériel]], [[wiki:modeles:portable|portable]], [[wiki:modeles:tutoriel|tutoriel]], [[wiki:modeles:utilisateur|utilisateur]]. | ||
| - | * [[wiki:ajout_image|Pour ajouter des images dans le wiki]]. | ||