- ArchWiki est réputé pour l’ampleur de sa documentation et sa grande qualité, et Debian a invité l’équipe de gestion du wiki d’Arch à intervenir à la DebConf25 afin de s’en inspirer
- La présentation a partagé, via une analyse SWOT, les points forts (contenu complet, actualité, influence) et les faiblesses (règles complexes, limites de MediaWiki, barrières à la contribution)
- Les principes d’exploitation du wiki chez Arch reposent notamment sur l’enregistrement des résumés de contribution, les modifications atomiques et la coordination via les pages de discussion
- Le processus de maintenance met l’accent sur l’usage de modèles et de bots, la participation aux revues communautaires et la prévention des conflits d’édition
- Juste après la présentation, Debian a lancé une migration vers MediaWiki, un changement de licence et la construction d’un nouveau site wiki, amorçant ainsi une refonte en profondeur
Stratégie d’ArchWiki et contexte de la collaboration avec Debian
- Le projet Arch Linux est bien connu dans la communauté Linux à la fois pour son modèle rolling release et pour la qualité remarquable de sa documentation
- D’innombrables utilisateurs consultent ArchWiki quelle que soit leur distribution, et Debian a lui aussi invité à la DebConf25 Jakub Klinkovský et Vladimir Lavallade, de l’équipe de gestion d’ArchWiki, afin d’améliorer la qualité de sa propre documentation
- Cette présentation a déclenché les discussions autour d’une refonte complète du wiki Debian
Vue d’ensemble d’ArchWiki et structure de fonctionnement
- ArchWiki a été lancé en 2004 ; il fonctionnait au départ avec PhpWiki avant de passer rapidement à MediaWiki
- Vers 2010, des équipes de maintenance et de traduction ont été mises en place pour gérer les règles que les contributeurs doivent connaître : consignes de contribution, style documentaire, structuration, etc.
- Il compte aujourd’hui plus de 4 000 pages thématiques et environ 30 000 pages au total en incluant les discussions et les redirections
- Depuis 2006, plus de 86 000 éditeurs ont réalisé plus de 840 000 modifications ; chaque mois, on y recense plus de 2 000 modifications et environ 300 contributeurs actifs
Les points forts d’ArchWiki
- Une couverture documentaire très large et un contenu complet sur des sujets variés
- Des mises à jour en temps réel qui reflètent en permanence l’état des paquets et de la distribution
- Une forte participation des contributeurs ordinaires en dehors de l’équipe de maintenance, dans une croissance portée par la communauté
- Une grande extensibilité, puisque tous les utilisateurs Linux s’y réfèrent bien au-delà de la communauté Arch
- Une structure documentaire concise et claire, qui facilite fortement la recherche d’information
Règles de contribution et lignes directrices pour le contenu
- Trois grands principes d’édition sont appliqués
- un résumé de modification est obligatoire après chaque changement
- les modifications complexes doivent être effectuées de manière atomique et progressive
- les changements importants doivent être annoncés à l’avance sur la page de discussion afin de recueillir les avis
- Sur le plan du contenu
- le principe DRY (Do not repeat yourself) est strictement appliqué
- la documentation reste simple tout en encourageant une exploration autonome
- les informations non vérifiées dans le contexte d’Arch ne sont pas acceptées, et le contenu est maintenu en adéquation avec Arch
Maintenance et gestion de la communauté
- Divers modèles et outils d’automatisation existent pour faciliter l’administration, la relecture et la catégorisation
- Tout le monde peut participer au processus de revue, mais l’examen effectif est surtout mené par les utilisateurs intéressés par chaque sujet
- Les erreurs ou problèmes peuvent être immédiatement signalés à l’aide de modèles de marquage
- Pour les modifications douteuses ou controversées, on cherche à recueillir l’avis majoritaire, avec une forte attention portée à la prévention des conflits d’édition
- Lorsqu’une aide est demandée sur les forums ou sur IRC, les utilisateurs sont systématiquement renvoyés vers le wiki, avec encouragement à créer du nouveau contenu si nécessaire
Les faiblesses d’ArchWiki
- La syntaxe complexe (balisage MediaWiki) et les règles constituent une barrière à l’entrée pour les nouveaux contributeurs
- Des règles structurelles comme le principe DRY sont difficiles à comprendre et à appliquer pour les débutants
- La plateforme MediaWiki elle-même, développée avant tout pour Wikipedia, entre partiellement en conflit avec les besoins d’Arch et présente des limites de personnalisation
- Sa syntaxe est particulière et difficile à interpréter, ce qui fragilise la maintenance et l’automatisation
- Le système de bénévolat fondé sur la popularité entraîne une mise à jour inégale des contenus et une actualisation parfois incohérente des informations
Opportunités et menaces
- Une extension du périmètre grâce aux liens avec la communauté et les distributions dérivées d’Arch
- L’usage d’outils d’assistance aux contributeurs comme wiki-scripts(Python) et Wiki Monkey(JavaScript)
- La possibilité future d’introduire des vérifications orthographiques (lint) ou un support IA, tout en tenant compte des risques de dégradation de qualité dus à des contenus IA non vérifiés et des problèmes liés aux bots de scraping
- Des contributions récentes utilisant l’IA ont causé des problèmes car elles ne respectaient pas les lignes directrices
- À long terme, la question de l’épuisement des contributeurs (burnout) implique la nécessité d’un afflux continu de nouveaux participants
Autres informations de fonctionnement et discussions
- Un salon de discussion dédié, #archlinux-wiki( Libera.Chat), est exploité, et les échanges sont orientés vers les pages Talk du wiki
- L’équipe de gestion compte entre 30 et 50 personnes, et l’infrastructure repose sur une seule machine virtuelle dans le cloud
- Quant au choix éventuel de reprendre MediaWiki, si des plugins et une API sont nécessaires, MediaWiki est privilégié ; sinon, une solution fondée sur Markdown peut aussi être envisagée
- Une forte hausse d’activité pendant la période Covid, suivie d’un déclin continu, a été observée ; une reprise est envisagée via une nouvelle architecture ou une intégration des distributions dérivées
Impact sur le projet Debian
- Juste après la présentation sur ArchWiki, Debian a lancé un projet de refonte (Revamp) du wiki
- décision de remplacer l’ancien MoinMoin par MediaWiki
- ouverture d’un nouveau wiki officiel (beta) et de la liste de diffusion debian-wiki
- à partir du 24 juillet 2025, les nouveaux contenus du wiki relèvent de la licence CC BY-SA 4.0
- Si cette dynamique d’amélioration se maintient, le wiki Debian pourrait atteindre une qualité comparable à celle d’ArchWiki
- On peut ainsi s’attendre à un cercle vertueux élargissant, pour tous les utilisateurs de Linux, un réservoir de connaissances open source à la fois extensible et fiable
Conclusion
- L’approche d’ArchWiki est reconnue, au-delà des distributions, comme un bon exemple de documentation collaborative pour l’ensemble de la communauté Linux/open source
- Cette interaction avec Debian symbolise la dynamique de diffusion et de standardisation des connaissances et du savoir-faire au sein de l’écosystème open source
Aucun commentaire pour le moment.