- 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
Panorama general de ArchWiki y su estructura operativa
- 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
Fortalezas de ArchWiki
- 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
Lineamientos de contribución y contenido
- 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
Mantenimiento y gestión de la comunidad
- 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
Debilidades de ArchWiki
- 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
Oportunidades y amenazas
- 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
Otra información operativa y discusión
- 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
Impacto en el proyecto Debian
- 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
Conclusión
- 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
1 comentarios
Comentarios de Hacker News
Creo que la wiki de Arch es uno de los mejores resultados que ha salido de la comunidad Linux
Se siente como una versión moderna y mejorada de TLDP
En realidad casi nunca he usado Arch, pero la wiki de Arch me ha ayudado muchísimo en distintos contextos, como estaciones de trabajo, servidores y sistemas personalizados basados en Yocto
La wiki de Arch cubre ampliamente distintos enfoques, así que es muy probable encontrar una guía relacionada sin importar la herramienta
Como Arch tiene pocos cambios respecto a upstream, la mayoría de las explicaciones también siguen siendo válidas en otras distribuciones
Claro, a veces hace falta distinguir casos especiales propios de Debian, por ejemplo, pero si ya conoces Linux, con frecuencia terminas comprobando que la wiki de Arch es la mejor documentación
Incluso antes de usar Arch, cuando tenía alguna situación ambigua con Ubuntu y buscaba en Google, siempre terminaba encontrando en la wiki de Arch alguna indicación tipo "si usas Ubuntu, resuélvelo así"
Me pasó muchas veces
Al leer esto, recordé que en los primeros tiempos de Gentoo también se decía algo muy parecido sobre la documentación de Gentoo
Después de usar FreeBSD u OpenBSD, uno se da cuenta de lo pobre que es relativamente la documentación en Linux
En los sistemas BSD, los comandos, programas, system calls y archivos de configuración están documentados de forma rigurosa en las páginas man y en las guías
En particular, el FreeBSD Handbook es un verdadero tesoro
La barrera de entrada del sistema operativo es relativamente alta, pero la documentación compensa perfectamente esa desventaja
En vez de crear muchas wikis separadas con un 80% de información duplicada, sería genial tener una wiki general que pudiera diferenciar por distribución
Antes Gentoo también tenía una wiki increíble, pero si no recuerdo mal, se perdió hace más de 10 años por una falla de un arreglo de discos
Ahora que todos terminan consultando la wiki de Arch, me pregunto si no sería mejor convertir archwiki en un proyecto compartido
Al final, lo más importante para hacer una buena wiki es la gente y las políticas
Una wiki pequeña, donde primero se sube cualquier cosa, puede ser excelente, pero el nivel del contenido y de las actualizaciones termina siendo muy desigual entre páginas
Si aumentan mucho las contribuciones, a los editores se les vuelve difícil poner orden, y la información no verificada se acumula hasta que se pierde la confianza
Por otro lado, si la edición es demasiado estricta, la información se vuelve vieja, conservadora y el lugar pierde interés
Al final, la ventaja es que distintas wikis pueden tener orientaciones diferentes
Si la gente o las políticas fallan en un lugar, hay alternativas
Si todos se concentran en un solo sitio, como esto depende de voluntarios, mucha gente va a desertar
Wikipedia es un caso de éxito excepcional; para todo lo demás, me parece más natural que esté disperso
Crear varias wikis redundantes es tanto una fortaleza como una debilidad del mundo Linux
Así como ya hay muchos entornos de escritorio y aun así siguen apareciendo más, y lo mismo pasa con los gestores de paquetes, que existan varias wikis es un fenómeno natural en el ecosistema Linux
Comparación de entornos de escritorio, lista de sistemas de gestión de paquetes, ranking de popularidad de distribuciones
La razón por la que no evolucionó de forma natural hacia una wiki general es, por lo común, que al principio cada distribución documenta solo sus partes específicas y luego va añadiendo contenido más general, pero al final sigue basándose en documentación propia de cada proyecto, así que hay poca disposición a compartir
Con el tiempo, si una wiki crece mucho y con éxito, termina asentándose silenciosamente como un estándar
Hace 25 años, las wikis eran algo nuevo y libre, así que había más entusiasmo por compartir contenido, pero con el tiempo cada quien tomó su propio rumbo y ese intercambio se fue diluyendo
Más recientemente pasó algo parecido en comunidades de gestión del conocimiento basadas en Markdown, pero sin grandes resultados
Compartir información en la práctica es más difícil de lo que parece
Antes había una wiki pequeña de visión por computadora que era bastante útil, pero alrededor de 2010 se decidió mover el contenido a Wikipedia
El resultado fue el esperado
La wiki original desapareció, solo sobrevivió una parte, y en Wikipedia tampoco quedó bien preservada
Al final, se perdió un gran recurso
En una wiki con un alcance demasiado amplio, es difícil saber en qué momento el contenido se volvió viejo o dejó de ser útil
Si se limita a un tema claro, como ArchWiki, se evita que se acumulen métodos obsoletos y se puede mantener la calidad
Siempre me impresiona lo pulida que está ArchWiki
No fue hasta que leí un gran artículo sobre systemd que por fin pude entenderlo bien
Después de ver el enlace donde un mantenedor de Arch explicaba por qué la distribución migró a systemd, pude aceptar el cambio
Cuando empecé en Linux usé Fedora y Ubuntu, pero siempre encontraba las respuestas a mis dudas en la wiki de Arch
Así que simplemente me cambié a Arch
En esa época, con solo buscar, la wiki de Arch siempre aparecía entre los primeros resultados, pero hace mucho que no la veo en los resultados de búsqueda
A mí me pasó lo mismo cuando intenté instalar Linux en una MacBook: la única wiki que daba información suficiente era la de Arch
Esa fue la principal razón por la que terminé probando Arch directamente
Me pregunto si ese artículo sobre systemd es este enlace
De ahora en adelante pienso dedicar más esfuerzo a editar la wiki que a escribir en la comunidad
La wiki y los paquetes son justamente las fortalezas de Arch
Los buenos resultados al final siempre salen de la colaboración manual
Además, borrar algo o no aceptar ciertos cambios no es fácil, pero es un proceso indispensable para la legibilidad de la wiki
Ojalá que el conocimiento que se maneja en Arch también llegue bien al lado de NixOS
Si uno mira la gráfica de usuarios activos mensuales de ArchWiki, parece que la tendencia a la baja empieza a partir de 2013
Salvo durante el periodo de confinamiento, la gráfica sigue cayendo en escalones
Me da curiosidad qué fue lo que pasó
Alrededor de 2012 empezó la migración a systemd, así que hubo necesidad de actualizar masivamente muchas páginas
Después de eso, volvió a bajar a niveles normales
Últimamente también puede haber influido que NixOS haya absorbido a algunos usuarios entusiastas
Antes Arch tenía la imagen de ser una distribución "poco amigable, para pros"
Pero en realidad era más fácil de usar de lo que parecía, y de ahí salió el meme de "I use Arch btw"
Parece que muchos de esos usuarios recientemente se pasaron a NixOS
2013 fue el año en que Manjaro empezó a ganar popularidad
Arch ya había cerrado sus foros desde 2011 por el exceso de popularidad
Enlace de referencia
También puede ser que casi toda la información importante ya esté escrita y quede menos por agregar
Una de las funciones que más he querido en la wiki de Arch es poder ocultar secciones según ciertas condiciones
Las guías presentan varias opciones, pero dependiendo de la opción que eliges, el resto deja de tener sentido
Sería muy cómodo poder marcar una elección y ocultar las partes posteriores que ya no apliquen
Me pregunto si es correcto compartir en Hacker News enlaces para suscriptores de artículos de lwn.net
Me preocupa si eso no termina perjudicando a lwn
Revisé el FAQ oficial y ahí se especifica que los enlaces para suscriptores pueden compartirse casi en cualquier parte
Dice que "agradecen que se compartan, siempre que no interfiera con sus intentos de conseguir suscriptores"
Enlace al FAQ
Compartir de vez en cuando este tipo de enlaces para suscriptores más bien tiene un efecto positivo
Si el contenido es bueno, ojalá la gente se suscriba para apoyar la producción de más contenido
De hecho, a mí me pasó que me suscribí a LWN gracias a este tipo de artículos de alta calidad
Normalmente se comparten usando el botón de "share link"
No hace falta iniciar sesión, pero las demás funciones exclusivas siguen siendo solo para suscriptores
Da una sensación curiosa eso de que sea "para suscriptores"
Como en la pantalla aparece el aviso "el siguiente contenido solo para suscriptores fue proporcionado por un suscriptor de LWN", queda claro que es una función pensada precisamente para eso
La wiki de Arch es algo así como la documentación de PostgreSQL dentro de Linux
Aunque no uses Arch ni Postgres directamente, sirve muy bien como punto de partida para entender la estructura o la forma de uso, y tiene suficiente información como para poder razonar a partir de ella
Una de las razones importantes por las que uso Arch es justamente la wiki
De nada sirve tener una buena función si no sabes que existe
Me gusta especialmente que explique por qué elegir cierto método, como en las secciones de "why" de cada enfoque
Un buen ejemplo es la página de data-at-rest encryption
Página de data-at-rest encryption