- 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
1 commentaires
Commentaires Hacker News
Je pense que l’Arch wiki est l’un des meilleurs résultats jamais produits par la communauté Linux
Cela donne l’impression d’un TLDP moderne et amélioré
En réalité, je n’ai presque jamais utilisé Arch moi-même, mais l’Arch wiki m’a énormément aidé dans des contextes variés : postes de travail, serveurs, systèmes personnalisés basés sur Yocto, etc.
L’Arch wiki couvre largement différentes approches, donc quel que soit l’outil, il y a de fortes chances qu’un guide pertinent existe
Comme Arch modifie peu l’upstream, les explications restent valables pour la plupart des autres distributions
Bien sûr, il faut parfois distinguer des cas particuliers propres à Debian, mais dès qu’on est à l’aise avec Linux, on constate souvent que l’Arch wiki est la meilleure documentation
Même avant d’utiliser Arch, quand je tombais sur une situation ambiguë avec Ubuntu en cherchant sur Google, je finissais toujours par trouver sur l’Arch wiki un passage du genre « pour les utilisateurs d’Ubuntu, faites ceci »
C’est arrivé plusieurs fois
En lisant cet article, je me suis souvenu qu’on disait la même chose de la documentation Gentoo à ses débuts
Après avoir utilisé FreeBSD ou OpenBSD, on se rend compte à quel point la documentation Linux est relativement pauvre
Dans les OS de la famille BSD, les commandes, programmes, appels système et fichiers de configuration sont tous documentés de façon rigoureuse dans les pages de man et les guides
Le FreeBSD Handbook en particulier est un véritable trésor
La barrière à l’entrée de l’OS est relativement élevée, mais la documentation compense parfaitement ce défaut
Au lieu de créer plusieurs wikis séparés qui contiennent 80 % d’informations redondantes, ce serait vraiment bien d’avoir un wiki générique capable de distinguer ce qui relève de chaque distribution
Gentoo avait aussi un wiki formidable autrefois, mais si je me souviens bien, il a été perdu il y a une dizaine d’années à cause d’une panne de baie de disques
Aujourd’hui, tout le monde va sur l’Arch wiki, alors je me dis qu’on pourrait peut-être faire évoluer archwiki en projet partagé
Au final, ce qui compte pour faire un bon wiki, ce sont les personnes et les règles
Un petit wiki est formidable parce qu’on peut y mettre un peu n’importe quoi au départ, mais le niveau du contenu et des mises à jour devient très inégal d’une page à l’autre
Quand les contributions affluent, les éditeurs finissent dépassés, des informations non vérifiées s’accumulent, puis le wiki perd en fiabilité
À l’inverse, si l’édition est trop stricte, l’information devient datée, conservatrice, et l’ensemble perd de son intérêt
Au fond, l’avantage, c’est justement que différents wikis puissent suivre des orientations différentes
Si les personnes ou les règles s’effondrent à un endroit, il existe des alternatives
Si on concentre tout en un seul lieu, comme il s’agit de bénévolat, beaucoup de gens risquent de décrocher
Wikipédia est un cas de réussite exceptionnel ; pour le reste, il est plus naturel que tout reste dispersé
Le fait de créer plusieurs wikis redondants est à la fois une force et une faiblesse du monde Linux
Il existe déjà toutes sortes d’environnements de bureau, et on en recrée encore ; pareil pour les gestionnaires de paquets, donc avoir plusieurs wikis est aussi un phénomène naturel dans l’univers Linux
Comparaison des environnements de bureau, Liste des systèmes de gestion de paquets, Classement de popularité des distributions
Si ces wikis n’ont pas évolué naturellement en wiki générique, c’est en général parce qu’au départ ils documentent seulement les aspects propres à chaque distribution, puis s’enrichissent progressivement de contenu plus général, mais restent malgré tout fondés sur une documentation spécifique à leur projet et donc peu enclins au partage
Avec le temps, lorsqu’un wiki parvient à grandir avec succès, il finit discrètement par s’imposer comme une sorte de standard
Il y a 25 ans, les wikis étaient encore nouveaux et libres, et l’envie de partager les contenus était forte ; avec le temps, chacun a pris sa propre direction et le partage entre eux s’est essoufflé
Plus récemment, on a vu une dynamique similaire dans les communautés de gestion des connaissances basées sur Markdown, sans résultats vraiment marquants
En pratique, le partage d’information est bien plus difficile qu’il n’y paraît
Il y avait autrefois un petit wiki assez utile dans le domaine de la vision par ordinateur, et vers 2010 il a été décidé d’en transférer le contenu vers Wikipedia
Le résultat a été exactement celui qu’on pouvait prévoir
Le wiki d’origine a disparu, seule une partie du contenu a survécu, et cela n’a pas vraiment subsisté correctement sur Wikipedia
Au final, une excellente ressource a été perdue
Quand un wiki couvre un périmètre trop large, il devient difficile de savoir à quel moment son contenu est obsolète ou inutile
En le limitant à un sujet clair comme Archwiki, on évite l’accumulation de méthodes dépassées et on préserve la qualité
Je suis toujours impressionné par le niveau de finition de l’Archwiki
C’est en lisant un excellent article sur systemd que j’ai enfin eu l’impression de vraiment comprendre le sujet
En voyant le lien expliquant pourquoi les mainteneurs d’Arch avaient fait basculer la distribution vers systemd, j’ai pu accepter ce changement
À mes débuts sur Linux, j’utilisais Fedora et Ubuntu, mais pour toutes mes questions, je finissais toujours par trouver la réponse sur l’Arch wiki
Du coup, je suis simplement passé à Arch
À l’époque, il suffisait de faire une recherche pour voir l’Arch wiki apparaître en tête des résultats, mais cela fait longtemps que je ne l’y vois plus
Moi aussi, quand j’ai voulu installer Linux sur un macbook, le seul wiki qui donnait suffisamment d’informations, c’était l’Arch wiki
C’est d’ailleurs la raison principale qui m’a poussé à essayer Arch moi-même
Je me demande si l’article sur systemd en question est ce lien
À l’avenir, je pense consacrer plus d’efforts à l’édition du wiki qu’à écrire dans la communauté
Le wiki et les paquets sont précisément les points forts d’Arch
Les bons résultats sont toujours le produit d’une collaboration artisanale
J’ajoute que supprimer des éléments ou refuser certaines modifications n’est pas simple non plus, mais c’est indispensable pour préserver la lisibilité du wiki
J’aimerais que les connaissances traitées côté Arch se transmettent aussi bien du côté de NixOS
Quand on regarde le graphique des utilisateurs actifs mensuels de l’ArchWiki, on a l’impression que le déclin a commencé autour de 2013
En dehors de la période des confinements, on voit une baisse en escalier se poursuivre
Je me demande ce qui s’est passé
Vers 2012, le début de la migration vers systemd a nécessité une mise à jour massive des pages
Ensuite, l’activité est redescendue à un niveau normal
Plus récemment, NixOS a probablement aussi attiré une partie des utilisateurs les plus passionnés
Arch avait autrefois la réputation d’être une distribution « pas conviviale, réservée aux pros »
Mais en réalité, elle était plus simple à utiliser qu’on ne le pensait, ce qui a aussi donné naissance au mème « I use Arch btw »
Il semble qu’une bonne partie de ces utilisateurs soit récemment passée à NixOS
2013 est l’année où Manjaro a commencé à gagner en popularité
Arch avait même verrouillé son forum dès 2011 à cause de sa popularité
Lien de référence
Il se peut aussi que l’essentiel des informations importantes soit déjà documenté, donc qu’il reste simplement moins de choses à écrire
L’une des fonctionnalités que j’aurais le plus aimé voir dans l’Arch wiki, c’est la possibilité de masquer des sections selon certaines conditions
Un guide peut présenter plusieurs options, mais selon l’option choisie, toute la suite devient sans intérêt
Il serait pratique d’avoir une fonction permettant de signaler un choix précis pour masquer ensuite les parties non pertinentes
Je me demande s’il est légitime de partager sur Hacker News des liens lwn.net réservés aux abonnés
Je crains que ce genre de pratique ne nuise à lwn
J’ai vérifié la FAQ officielle, et il y est clairement indiqué que les liens abonnés peuvent être partagés presque partout
Ils disent même qu’ils accueillent favorablement le partage « tant que cela ne compromet pas les efforts visant à gagner des abonnés »
Lien vers la FAQ
Partager de temps en temps des liens abonnés de cette manière a plutôt un effet positif
Si le contenu est bon, j’espère que les gens s’abonneront pour soutenir la production de davantage de contenus
En fait, c’est aussi grâce à ce genre d’articles de fond que je me suis abonné à LWN
En général, le lien a été partagé via le bouton « share link »
Il n’est pas nécessaire de se connecter, mais les autres fonctions réservées aux abonnés restent bien limitées aux abonnés
Le fait que ce soit un lien abonné donne une impression un peu étrange
Comme un message à l’écran précise que « le contenu réservé aux abonnés qui suit a été fourni par un abonné LWN », il est clair qu’il s’agit d’une fonctionnalité prévue à cet effet
L’Arch wiki est pour Linux ce que la documentation PostgreSQL est à son écosystème
Même sans utiliser directement Arch ou Postgres, cela constitue un excellent point de départ pour comprendre la structure ou l’usage, et l’information est suffisamment riche pour permettre aussi de raisonner par déduction
L’une des raisons importantes pour lesquelles j’utilise Arch, c’est précisément son wiki
Une bonne fonctionnalité ne sert à rien si on ignore son existence
J’apprécie en particulier les sections « why » de certaines méthodes, qui expliquent pourquoi faire tel ou tel choix
Un bon exemple est la page sur le chiffrement des données au repos
Page sur le chiffrement des données au repos