| Les deux révisions précédentesRévision précédente | |
| wiki:participer_wiki [Le 25/05/2026, 23:43] – suppr backlink modele protable krodelabestiole | wiki:participer_wiki [Le 10/07/2026, 23:26] (Version actuelle) – liste de discussion -> forum | formulations plus inclusives | màj krodelabestiole |
|---|
| ====== Comment participer et améliorer cette documentation ? ===== | ====== 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. | 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 ! | Merci d'avance pour vos contributions ! |
| <note>Pour connaître d'autres façons de contribuer à Ubuntu, consultez [[:comment_participer|cette page]].</note> | <note> |
| | Pour connaître d'autres façons de contribuer à Ubuntu, consultez [[:comment_participer|cette page]]. |
| | </note> |
| |
| ===== Les règles du wiki ===== | ===== Les règles du wiki ===== |
| |
| 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]]. | 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]]. |
| 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. | |
| | 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 : | Aussi, il y a des règles de bon sens auxquelles il est demandé de se conformer : |
| * Respecter les contributions pertinentes des autres utilisateurs ([[:codedeconduite|code de conduite]]). | * 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 que le lecteur ne soit pas perdu en passant de l'une à l'autre. | 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. |
| |
| <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> | <note tip> |
| | 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]]. |
| | </note> |
| |
| ===== Apprendre à créer et à modifier des pages ===== | ===== Apprendre à créer et à modifier des pages ===== |
| |
| <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> | <note important> |
| | 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. |
| | </note> |
| |
| ==== Les modèles ==== | ==== Les modèles ==== |
| * pour présenter un périphérique, le modèle [[wiki:modeles:materiel|Matériel]] ; | * 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 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 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]]. | * 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 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 ==== | ==== Modifier une page ==== |
| ==== Contributeur ==== | ==== Contributeur ==== |
| |
| 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,.. | 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. | 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. |
| |
| {{:wiki-participer_wiki-mattermost-doc.png?400}} | {{:wiki-participer_wiki-mattermost-doc.png?400}} |
| |
| ==== La liste de diffusion ==== | |
| |
| 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. | |
| |
| <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]]**. | |
| |
| <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> | |
| |
| ===== Trucs et astuces ===== | ===== Trucs et astuces ===== |
| |
| ==== Par où commencer ? ==== | ==== 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 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... ==== | ==== 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. 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. | 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. | * [[https://forum.ubuntu-fr.org/viewtopic.php?id=2093942|Discussion]] au sujet de cette page sur le forum. |
| * //[[:Contributeurs]]// | |