ArchWiki:Contributing (Français)

From ArchWiki
État de la traduction: Cet article est la version francophone de ArchWiki:Contributing. Date de la dernière traduction: 24 mars 2024. Vous pouvez aider à synchroniser la traduction s'il y a eu des changements dans la version anglaise.

Le Code de conduite d'Arch Linux régit tous les projets Arch.

ArchWiki s'efforce d'être un modèle de documentation clair, complet et professionnel. Afin d'atteindre cet objectif, nous devons organiser le travail de manière rationnelle et fonctionnelle : cet article tente d'expliquer schématiquement quelles sont les tâches les plus importantes que vous pouvez accomplir avec votre aide.

Il s'agit d'un effort communautaire, mais si vous prenez la tâche au sérieux, une position formelle en tant que wiki maintainer (en) peut être envisagée.

Les 3 règles fondamentales

Il y a 3 règles simples que tous les contributeurs, y compris les novices, devraient s'efforcer de suivre en signe de respect envers les autres utilisateurs du wiki : #Toujours utiliser correctement le résumé d'édition, #Ne pas faire d'éditions complexes en une seule fois et #Annoncer les réécritures d'articles dans une page de discussion.

Tous les contributeurs du wiki doivent s'attendre à ce que d'autres utilisateurs vérifient leurs modifications tôt ou tard, et respecter leur droit de le faire en rendant la vérification aussi rapide et facile que possible en suivant ces règles. Les personnes familiarisées avec les projets de logiciels collaboratifs comprendront facilement l'analogie entre les résumés d'édition wiki et les messages de validation git, ainsi qu'entre les différences d'édition wiki et les différences git.

Attention: Toute modification d'article qui ne respecte pas ces règles fondamentales et qui, de ce fait, ne peut être comprise avec un effort raisonnable, peut être complètement annulée sans avertissement, en particulier lorsqu'elle affecte des articles populaires.

Toujours utiliser correctement le résumé d'édition

Le résumé d'édition est la petite zone de texte qui se trouve sous la zone d'édition principale et juste au-dessus du bouton Save changes ou Save page. Il est très important de toujours écrire, de manière succincte, ce qui a été fait et pourquoi. Notez que les Liens interwiki fonctionne dans les résumés d'édition, utilisez-les donc pour renvoyer à des discussions ou des articles connexes ; de même, collez les URL vers les différences d'édition pertinentes ou les ressources externes, comme les fils de discussion des forums ou les listes de diffusion.

La partie "pourquoi" ne peut être omise que dans le cas d'éditions mineures, par exemple des corrections grammaticales ou orthographiques ou la simple reformulation d'une phrase ; de la même manière, lancer une nouvelle discussion ou répondre à une discussion existante ne nécessite pas de reformuler le message dans le résumé d'édition.

Note: En cliquant sur edit dans l'en-tête d'une section, /* Nom de la section */ est prérempli dans le champ du résumé. Il ne s'agit pas d'une syntaxe de commentaire. Le texte entre /* et */ est transformé en lien vers une section de la page. Ajoutez votre résumé d'édition à la suite.
Astuce:
  • Jetez un coup d'œil aux résumés d'édition dans la section Modifications récentes pour avoir une idée de ce que vous devriez écrire dans votre résumé, mais sachez que tous les utilisateurs ne sont malheureusement pas au courant de ces directives.
  • Utilisez des liens comme Special:Diff/359881/next pour des références cliquables aux différences, voir mw:Help:Diff/fr pour les détails de la syntaxe.

Ne pas faire d'éditions complexes en une seule fois

Si vous souhaitez apporter une modification importante à une page, qu'il s'agisse d'un article normal ou d'une page de discussion, divisez toujours votre travail en plusieurs éditions simples, par exemple en fonction des différentes étapes logiques nécessaires à sa réalisation. En cas de doute, prévoyez un aperçu du résultat des diff avec le bouton Afficher les modifications et demandez-vous si un autre utilisateur serait en mesure de le comprendre, en tenant compte également du résumé de l'édition comme expliqué ci-dessus. Voici quelques opérations courantes qui génèrent des différences qui prêtent à confusion :

  • Déplacer une section dans un article et en même temps modifier son contenu. Solution : déplacer la section sans la modifier, sauvegarder et modifier son contenu lors d'une prochaine édition.
  • Réorganiser plusieurs sections d'un article en même temps. Solution : ne déplacer qu'une seule section par édition.
Note: Cette pratique augmentera naturellement le nombre d'entrées dans Modifications récentes : ne vous inquiétez pas, les utilisateurs peuvent facilement filtrer cette liste en activant le paramètre Grouper les changements par page dans les changements récents et la liste de surveillance dans Préférences > Changements récents > Options avancées.

Annoncer les réécritures d'articles dans une page de discussion

Si vous souhaitez restructurer ou réécrire radicalement un article ou un groupe d'articles, annoncez et expliquez d'abord votre intention dans une page de discussion appropriée, en donnant aux autres utilisateurs intéressés un délai raisonnable pour répondre et partager leur point de vue.

Gardez à l'esprit que l'annonce des changements envisagés n'exempte pas les éditions des règles suivantes : #Toujours utiliser correctement le résumé d'édition et #Ne pas faire d'éditions complexes en une seule fois.

La tâche la plus importante

Dans la suite de cet article, nous vous présenterons les différentes façons de contribuer au wiki. Parmi elles, il y en a une que vous devriez considérer comme bien plus importante que les autres : ajouter vos articles préférés à votre liste de surveillance et les protéger contre les éditions contre-productives.

Chaque jour, l'ArchWiki reçoit plusieurs dizaines d'éditions de la part de nombreux utilisateurs différents : alors que la plupart de ces changements sont de réelles améliorations, il suffit d'une seule édition, souvent faite de bonne foi, pour altérer de manière inexacte le sens d'un paragraphe entier ou d'une section, ou parfois même le supprimer complètement de manière déraisonnable. Si cela passe inaperçu, cela ruinera le travail précieux que vous et tous les autres éditeurs précédents avaient fait. Malheureusement, cela arrive plus souvent qu'on ne le pense : l'équipe officielle du wiki fait de son mieux pour filtrer et corriger les modifications contre-productives. Vous ne devez cependant jamais lui faire entièrement confiance, puisque, tout comme vous, elle a un temps limité à consacrer au wiki. Elle n'est pas omnisciente, il est aussi très probable que vos connaissances sur les sujets traités dans vos articles préférés soient supérieures que l'équipe du wiki. En général, un wiki ne fonctionne tout simplement pas si les utilisateurs se concentrent uniquement sur l'écriture de nouveaux contenus et ne se soucient pas de ce qu'il advient de leurs contributions.

Heureusement, il existe un moyen très simple de suivre les articles auxquels vous avez contribué ou ceux que vous aimez le plus ou que vous connaissez le mieux : en haut de chaque article, il y a un lien "Ajouter cette page à cotre liste de suivis", en cliquant dessus, cet article sera ajouté à votre liste de suivi. Vous pourrez alors suivre les modifications dans Special:Watchlist, ou en choisissant d'être notifié par courriel lorsque les articles surveillés reçoivent des mises à jour dans le champ "Options de courriel" de Special:Preferences#mw-prefsection-personal-email ; les pages que vous suivez seront également mises en évidence en gras dans Modifications récentes. Enfin, les préférences pour la liste de suivi se trouvent dans Special:Preferences#mw-prefsection-watchlist : parmi les options, vous pouvez même choisir de commencer à suivre automatiquement les pages que vous créez ou modifiez.

Si vous remarquez qu'un article de votre liste de suivis a été édité de manière incorrecte, ou que vous ne le comprenez tout simplement pas, nous vous encourageons vivement à le corriger, si possible, ou à lancer une discussion dans la page de discussion de l'article, ou dans la page de discussion de l'auteur responsable.

Ressources

Voici une liste de pages qui contiennent des informations nécessaires pour contribuer :

  • Help:Article naming guidelines présente des stratégies de nommage d'articles efficaces et des considérations pour assurer la lisibilité et améliorer la navigation sur le wiki. Lisez-le avant de créer une nouvelle page.
  • Help:Editing (Français) décrit à la fois le balisage MediaWiki largement connu et les directives spécifiques à ArchWiki. Une lecture indispensable pour tous les contributeurs potentiels.
  • Help:Discussion vous guide sur la façon de discuter avec les gens dans les pages de discussion.
  • Help:Style donne des directives pour la standardisation du style dans les articles de l'ArchWiki.
  • Help:Category explique comment définir les catégories de pages, comment créer des pages de catégories manquantes et comment déplacer une page dans une catégorie différente.
  • ArchWiki:Translation Team (Français) a une introduction étape par étape pour créer une nouvelle page de traduction. Suivez-la pour traduire des pages dans votre propre langue.
  • Help:i18n (Français) sert de guide complet pour l'internationalisation et la localisation d'ArchWiki.
  • Help:Procedures est une collection de listes de contrôle utiles pour les opérations complexes.

Consulter Category:Help (Français) pour tous les articles d'aide.

Créer

Assurez-vous de comprendre la philosophie de l'ArchWiki et pensez à ce que les autres pourraient vouloir lire (voir ArchWiki:Requests pour des idées). Comme mentionné, le champ d'application du wiki est assez large.

Parlez à l'équipe de maintainance pour obtenir de l'aide dans la coordination des projets majeurs.

Help:Editing (Français)#Créer une page couvre les étapes de création d'un nouvel article dans le namespace principal.

La fonction de sous-page du wiki (article/sous-page) est également disponible pour votre page utilisateur. En l'utilisant, vous pouvez créer le brouillon d'une sous-page vierge. Veuillez noter que le contenu de la page d'utilisateur ne doit pas être catégorisé, mais que toutes les autres fonctions peuvent être utilisées. Une fois la rédaction terminée, vous pouvez simplement déplacer la sous-page vers son nouveau nom. Veuillez ajouter les modèles de statut d'article pertinents (uniquement) après l'avoir déplacée. Plus vous décrivez la raison d'un modèle de statut, plus il est facile pour les utilisateurs #Améliorer du wiki de collaborer avec vous.

Améliorer

L'édition, la relecture et la mise à jour du contenu sont des tâches sans fin sur n'importe quel wiki. Si vous voulez nous aider, il vous suffit de créer un compte et de commencer à faire de la magie.

Utilisateurs non-Arch

Tout le monde peut créer un compte : les utilisateurs non-Arch sont les bienvenus pour contribuer au contenu qui s'applique à d'autres distributions Linux ou systèmes d'exploitation, tant qu'ils sont sûrs qu'il s'applique également à Arch Linux. En particulier, les articles doivent être écrits spécifiquement pour les utilisateurs d'Arch, donc :

  • n'ajoutez pas de commentaires propres à d'autres distributions Linux ou systèmes d'exploitation ; par exemple, un utilisateur de Fedora contribuant à la page systemd serait bien, mais mentionner que le contenu nouvellement ajouté fonctionne sur Fedora serait édité comme non pertinent ;
  • ne pas remplacer les mentions de conventions, de terminologie ou d'utilitaires spécifiques à Arch par des alternatives qui peuvent s'appliquer à une gamme plus large de systèmes d'exploitation.

Maintenir

  • Aider à patrouiller dans la section modifications récentes, en signalant et en corrigeant les éditions douteuses.
  • Signaler les articles avec les statut de l'article appropriés, comme {{Out of date}}, {{Accuracy}}, {{Remove}}, {{Archive}}, etc.
  • Ajoutez vos articles préférés à votre liste de surveillance et protégez-les contre les modifications contre-productives (#La tâche la plus importante).
  • Participer aux discussions dans les différentes pages de discussion : la plupart des utilisateurs seront intéressés par les messages les plus récents des discussions génériques sur ce lien. Les messages spécifiques à la maintenance sont plutôt listés dans [1], [2], [3] et [4].

Organiser

Le tri, la catégorisation et le déplacement des articles sont devenus une tâche majeure pour tous les mainteneurs de wiki qui mettent en œuvre et améliorent la arborescence des catégories.

Traduire

Pour les page traduites avec les templates Translateme ou Bad translation, s'assurer que les traductions sont synchronisées les unes avec les autres.

Certaines langues ont lancé des projets de collaboration (voir la liste ci-dessous) pour organiser efficacement la traduction des articles. Veuillez envisager de rejoindre l'équipe de traduction de votre langue ou au moins de l'informer lorsque vous commencez à traduire un article.

Certaines langues utilisent des wikis externes, qui peuvent nécessiter des étapes différentes pour la traduction. Help:i18n (Français) contient une liste de wikis externes.

Traduction des messages spéciaux

Il y a quelques messages spéciaux utilisés dans le Wiki d'Arch, veuillez fournir leur traduction pour votre langue dans le lien suivant :

  • Également dans (Message dans l'arbre des catégories) : Ajouter la traduction ici.
  • Talkpagetext : Ajouter la traduction ici.

Brainstorming

Pour coordonner les contributions avec d'autres utilisateurs en temps réel, il existe un canal IRC officiel dédié #archlinux-wiki. IRC. Si vous ne savez pas par où commencer, ou si vous vous sentez mal à l'aise à l'idée d'éditer le travail d'autres personnes, vous pouvez également contribuer en postant des idées et des suggestions dans la section Forum & Wiki discussion du Forum Arch Linux.

Maintenance du back-end

Utilisez le Bugtracker Arch Linux pour signaler les bugs et contribuer aux corrections et améliorations de la base de code MediaWiki. Voir la liste des bugs signalés pour le back-end ArchWiki.

Plaintes

Si vous avez des remarques négatives ou des plaintes génériques sur la façon dont le wiki est modéré ou administré, veuillez laisser un message dans ArchWiki talk:Maintenance Team. Bien sûr, il n'est pas nécessaire de préciser qu'il est possible de se plaindre de quelque chose en utilisant un ton civil et respectueux :)

Tous les endroits et méthodes appropriés pour les plaintes et les commentaires sont décrits dans ArchWiki:Maintenance Team#Who, when and how to contact.