Arch teilt Wiki-Strategie mit Debian

(lwn.net)

4 Punkte von GN⁺ 2025-08-16 | Noch keine Kommentare. | Auf WhatsApp teilen

ArchWiki ist für seine umfangreiche Dokumentation und hohe Qualität bekannt; Debian lud deshalb zur DebConf25 das Arch-Wiki-Team als Vortragende ein, um sich daran zu orientieren
Im Vortrag wurden per SWOT-Analyse die Stärken (umfassende Inhalte, Aktualität, Einfluss) und Schwächen (komplexe Regeln, Grenzen von MediaWiki, Hürden für Beiträge) vorgestellt
Die Grundsätze für den Betrieb des Wikis bei Arch umfassen unter anderem Edit-Summaries protokollieren, atomare Bearbeitungen und Abstimmung über Diskussionsseiten
Im Wartungsprozess wurden der Einsatz von Templates und Bots, die Beteiligung an Community-Reviews sowie die Vermeidung von Edit-Konflikten hervorgehoben
Unmittelbar nach dem Vortrag stieß Debian eine umfassende Überarbeitung an, darunter die Migration zu MediaWiki, eine Lizenzänderung und den Aufbau einer neuen Wiki-Site

Hintergrund zur ArchWiki-Strategie und zur Zusammenarbeit mit Debian

Das Arch-Linux-Projekt ist in der Linux-Community neben seinem Rolling-Release-Modell auch für seine hervorragende Dokumentation bekannt
Zahlreiche Nutzer greifen unabhängig von der Distribution auf das ArchWiki zurück; auch Debian lud daher die ArchWiki-Betreuer Jakub Klinkovský und Vladimir Lavallade zur DebConf25 ein, um die Qualität der eigenen Dokumentation zu verbessern
Dieser Vortrag wurde zum Auslöser für die Diskussion über einen vollständigen Umbau des Debian-Wikis

Das ArchWiki startete 2004; anfangs lief es auf PhpWiki, wurde aber bald auf MediaWiki umgestellt
Etwa ab 2010 wurden Wartungs- und Übersetzungsteams aufgebaut, die Richtlinien für Beiträge, Dokumentationsstil und Struktur verwalten
Inzwischen ist es auf mehr als 4.000 Themenseiten und insgesamt rund 30.000 Seiten inklusive Diskussionen und Weiterleitungen angewachsen
Seit 2006 haben mehr als 86.000 Bearbeiter über 840.000 Edits vorgenommen; pro Monat gibt es mehr als 2.000 Edits und rund 300 aktive Mitwirkende

Breite Dokumentationsabdeckung und umfassende Inhalte zu vielen unterschiedlichen Themen
Laufende Aktualisierungen, die den Zustand von Paketen und Distribution stets zeitnah widerspiegeln
Starke Beteiligung gewöhnlicher Mitwirkender jenseits des Wartungsteams, also gemeinschaftsbasiertes Wachstum
Besonders hervorzuheben ist die große Reichweite: Das Wiki dient nicht nur der Arch-Community, sondern Linux-Nutzern insgesamt als Referenz
Eine knappe und klare Struktur der Dokumentation sorgt für hohe Auffindbarkeit von Informationen

Es gibt drei zentrale Bearbeitungsprinzipien
- Nach jeder Änderung ist eine Edit-Summary verpflichtend
- Komplexe Änderungen sollen atomar und schrittweise erfolgen
- Größere Änderungen werden vorab auf der Diskussionsseite angekündigt, um Meinungen einzuholen
Bei den Inhalten gilt
- Das DRY(Do not repeat yourself)-Prinzip wird strikt durchgesetzt
- Dokumente bleiben einfach, fördern aber eigenständige Erkundung
- Nicht für Arch verifizierte Informationen werden nicht übernommen; Inhalte werden an Arch ausgerichtet gehalten

Es gibt verschiedene Templates und Automatisierungstools, die Verwaltung, Prüfung und Kategorisierung unterstützen
Am Review-Prozess kann sich jeder beteiligen; die eigentliche Prüfung wird meist von Nutzern übernommen, die sich für das jeweilige Thema interessieren
Fehler oder Probleme können sofort mit Flag-Templates markiert werden
Bei fragwürdigen oder umstrittenen Edits wird ein Meinungsbild eingeholt; die Vermeidung von Edit-Streitigkeiten hat hohen Stellenwert
Wer in Foren oder per IRC Hilfe sucht, wird konsequent auf das Wiki verwiesen; bei Bedarf wird auch zum Anlegen neuer Inhalte ermutigt

Komplexe Syntax (MediaWiki-Markup) und Richtlinien stellen für neue Mitwirkende eine Einstiegshürde dar
Strukturelle Regeln wie das DRY-Prinzip sind für Einsteiger oft schwer zu verstehen und umzusetzen
Die MediaWiki-Plattform selbst wird primär mit Blick auf Wikipedia entwickelt und passt daher nur teilweise zu den Bedürfnissen von Arch; die Möglichkeiten zur Anpassung sind begrenzt
Die Syntax ist ungewöhnlich und schwer zu interpretieren, was Wartung und Automatisierung erschwert
Das freiwilligenbasierte System orientiert sich an Popularität, wodurch Aktualisierungen ungleich verteilt und Informationsstände uneinheitlich sein können

Erweiterung des Wirkungsbereichs durch Verknüpfungen mit der Community und Arch-Derivaten
Nutzung von Hilfswerkzeugen für Mitwirkende wie wiki-scripts(Python) und Wiki Monkey(JavaScript)
Für die Zukunft wird der Einsatz von Rechtschreibprüfung (Lint) oder KI-Unterstützung geprüft; zugleich müssen Qualitätsverluste durch ungeprüft KI-generierte Inhalte und Probleme mit Scraper-Bots berücksichtigt werden
Zuletzt führten KI-gestützte Beiträge, die nicht mit den Richtlinien vereinbar waren, bereits zu Problemen
Langfristig ist wegen Burnout unter Mitwirkenden ein kontinuierlicher Zufluss neuer Kräfte notwendig

Es gibt den eigenen Chatraum #archlinux-wiki auf Libera.Chat; Diskussionen werden auf die Talk-Seiten im Wiki gelenkt
Das Wartungsteam umfasst 30 bis 50 Personen; die Infrastruktur basiert auf einer einzelnen virtuellen Maschine in der Cloud
Bei der Frage, ob erneut MediaWiki gewählt werden sollte, gilt: Wenn Plugins und APIs benötigt werden, MediaWiki; andernfalls kommen auch Markdown-basierte Lösungen infrage
Während der Corona-Zeit nahm die Aktivität stark zu und ging danach kontinuierlich zurück; neue Architekturen oder die Einbindung von Derivaten könnten wieder für Aufschwung sorgen

Direkt nach dem ArchWiki-Vortrag startete Debian ein Wiki-Revamp-Projekt
- Es wurde beschlossen, das bisherige MoinMoin durch MediaWiki zu ersetzen
- Ein neues offizielles Wiki (beta) und die Mailingliste debian-wiki wurden eröffnet
- Neue Wiki-Inhalte stehen seit dem 24. Juli 2025 unter der CC BY-SA 4.0-Lizenz
Wenn der aktuelle Verbesserungsschwung anhält, könnte auch das Debian-Wiki eine Qualität auf dem Niveau des ArchWiki erreichen
Damit zeichnet sich ein positiver Kreislauf ab, in dem ein skalierbares und vertrauenswürdiges Open-Source-Wissensarchiv für alle Linux-Nutzer weiter wächst

Der ArchWiki-Ansatz gilt distributionsübergreifend als gutes Beispiel für kollaborative Dokumentation in der Linux- und Open-Source-Community
Die aktuelle Interaktion mit Debian ist ein symbolträchtiges Ereignis für die Verbreitung und Standardisierung von Wissen und Know-how im Open-Source-Ökosystem