Arch comparte con Debian su estrategia de wiki

(lwn.net)

4 puntos por GN⁺ 2025-08-16 | Aún no hay comentarios. | Compartir por WhatsApp

ArchWiki es famosa por su enorme volumen de documentación y su alta calidad, y Debian invitó a ponentes del equipo operativo de la wiki de Arch a DebConf25 para tomarla como referencia
En la presentación compartieron un análisis FODA con fortalezas (contenido integral, actualidad, influencia) y debilidades (reglas complejas, límites de MediaWiki, barreras para contribuir)
Los principios de operación de la wiki de Arch incluyen registrar resúmenes de edición, hacer ediciones atómicas y coordinarse mediante páginas de discusión
En el mantenimiento se enfatiza el uso de plantillas y bots, la participación en revisiones comunitarias y la prevención de guerras de edición
Justo después de la presentación, Debian impulsó la migración a MediaWiki, un cambio de licencia y la construcción de un nuevo sitio de wiki, iniciando una renovación de fondo

Estrategia de ArchWiki y contexto de la colaboración con Debian

El proyecto Arch Linux es ampliamente conocido en la comunidad Linux por su modelo rolling release y su excelente documentación
Usuarios de todo tipo de distribuciones consultan ArchWiki, y Debian invitó a Jakub Klinkovský y Vladimir Lavallade, del equipo administrador de ArchWiki, a DebConf25 para elevar la calidad de su propia documentación
A partir de esta charla comenzó el debate sobre una renovación integral de la wiki de Debian

ArchWiki comenzó en 2004; al inicio funcionaba con PhpWiki, pero pronto migró a MediaWiki
Hacia 2010 se formaron un equipo de mantenimiento y un equipo de traducción, encargados de gestionar las reglas que deben conocer quienes contribuyen, como lineamientos, estilo documental y estructura
Hoy ha crecido hasta superar las 4,000 páginas temáticas, y ronda las 30 mil páginas en total incluyendo discusiones y redirecciones
Desde 2006, más de 86,000 editores han realizado más de 840 mil ediciones; cada mes registra más de 2,000 ediciones y unos 300 contribuidores activos

Proporciona contenido amplio y completo sobre una gran variedad de temas
Se mantiene al día con actualizaciones en tiempo real que reflejan siempre el estado de los paquetes y la distribución
Además del equipo de mantenimiento, hay una participación activa de contribuidores generales, lo que impulsa su crecimiento comunitario
Su gran rasgo distintivo es la escalabilidad, ya que la consultan todos los usuarios de Linux, no solo la comunidad Arch
Tiene una estructura documental concisa y clara, lo que facilita mucho la búsqueda de información

Existen tres principios principales de edición
- Después de cada cambio, el resumen de edición es obligatorio
- Las modificaciones complejas deben realizarse de forma atómica y por etapas
- Los cambios importantes requieren aviso previo en la página de discusión para recoger opiniones
En cuanto al contenido
- Se hace cumplir el principio DRY (Do not repeat yourself)
- Los documentos se mantienen simples, pero fomentando la exploración autónoma
- No se acepta información que no haya sido verificada sobre Arch, y el contenido se mantiene ajustado a Arch

Existen varias plantillas y herramientas de automatización que ayudan con administración, revisión y clasificación
Cualquiera puede participar en el proceso de revisión, pero la validación práctica suele estar liderada por usuarios interesados en cada tema
Los errores o problemas pueden marcarse de inmediato con plantillas de aviso
Las ediciones dudosas o polémicas se someten a la opinión de la mayoría, y se da mucha importancia a evitar disputas de edición
Cuando alguien pide ayuda en foros o en IRC, siempre se le dirige a la wiki y, si hace falta, se le anima a crear contenido nuevo

La sintaxis compleja (marcado de MediaWiki) y los lineamientos actúan como barrera de entrada para nuevos contribuidores
Reglas estructurales como el principio DRY pueden ser difíciles de entender y aplicar para principiantes
La propia plataforma MediaWiki, desarrollada principalmente con Wikipedia en mente, choca en parte con las necesidades de Arch y limita la personalización
Su sintaxis es peculiar y difícil de interpretar, lo que la vuelve frágil para el mantenimiento y la automatización
Al depender de un sistema voluntario guiado por la popularidad, hay sesgos en qué contenidos se actualizan y cierta inconsistencia en la renovación de la información

Puede ampliar su alcance mediante la conexión con la comunidad y las distribuciones derivadas de Arch
Se apoya en herramientas auxiliares para contribuidores como wiki-scripts(Python) y Wiki Monkey(JavaScript)
A futuro se explora la posibilidad de introducir revisión ortográfica (lint) o soporte con IA (aunque hay que considerar el deterioro de calidad por contenido generado por IA no verificado y el problema de los bots recolectores)
Recientemente, algunas contribuciones con IA no han cumplido los lineamientos y han generado problemas
A largo plazo, el problema del agotamiento de contribuidores (burnout) hace necesario incorporar gente nueva de manera continua

Se opera una sala de chat dedicada, #archlinux-wiki, en Libera.Chat, y las discusiones se canalizan hacia las páginas Talk dentro de la wiki
El equipo administrador tiene entre 30 y 50 personas, y la infraestructura se basa en una sola máquina virtual en la nube
Sobre si volverían a elegir MediaWiki, consideran MediaWiki si se necesitan plugins y API; de lo contrario, también contemplan soluciones basadas en Markdown
Se observó un fuerte aumento de actividad durante la pandemia y una disminución sostenida después, por lo que se explora la posibilidad de repuntar con una nueva arquitectura o con integración de derivadas

Justo después de la presentación sobre ArchWiki, Debian puso en marcha el proyecto de renovación (Revamp) de su wiki
- Se decidió reemplazar el antiguo MoinMoin por MediaWiki
- Se abrió una nueva wiki oficial (beta) y la lista de correo debian-wiki
- Desde el 24 de julio de 2025, el contenido nuevo de la wiki estará bajo la licencia CC BY-SA 4.0
Si el impulso de mejora se mantiene, se espera que la wiki de Debian pueda alcanzar una calidad comparable a la de ArchWiki
Se perfila un círculo virtuoso en el que crece un repositorio de conocimiento open source más amplio, confiable y útil para todos los usuarios de Linux

El enfoque de ArchWiki es reconocido, más allá de una sola distribución, como un buen ejemplo de documentación colaborativa para toda la comunidad Linux/open source
Esta interacción con Debian simboliza la expansión y estandarización del conocimiento y el know-how dentro del ecosistema open source