- A ArchWiki é famosa por sua vasta documentação e alta qualidade, e o Debian convidou a equipe responsável pela wiki do Arch para palestrar na DebConf25 como referência para benchmarking
- Na apresentação, foi compartilhada uma análise SWOT com pontos fortes (conteúdo abrangente, atualização constante, influência) e pontos fracos (regras complexas, limitações do MediaWiki, barreiras à contribuição)
- Os princípios de operação da wiki do Arch incluem registro de resumos de edição, edições atômicas e coordenação por meio de páginas de discussão
- No processo de manutenção, foram enfatizados o uso de templates e bots, participação na revisão pela comunidade e prevenção de conflitos de edição
- Logo após a apresentação, o Debian passou a promover migração para MediaWiki, mudança de licença e construção de um novo site de wiki, iniciando uma reformulação em grande escala
Estratégia da ArchWiki e contexto da colaboração com o Debian
- O projeto Arch Linux é amplamente conhecido na comunidade Linux tanto por seu modelo rolling release quanto por sua excelente documentação
- Usuários de inúmeras distribuições consultam a ArchWiki, e o Debian, buscando elevar a qualidade de sua própria documentação, convidou Jakub Klinkovský e Vladimir Lavallade, da equipe de manutenção da ArchWiki, para a DebConf25
- A partir dessa apresentação, começou a discussão sobre uma reformulação completa da wiki do Debian
Visão geral da ArchWiki e estrutura de operação
- A ArchWiki começou em 2004 e, no início, era operada com PhpWiki, mas logo migrou para MediaWiki
- Por volta de 2010, foram formadas a equipe de manutenção e a equipe de tradução, que passaram a administrar regras que os colaboradores precisam conhecer, como diretrizes de contribuição, estilo dos documentos e estruturação
- Hoje, ela cresceu para mais de 4.000 páginas de tópicos e cerca de 30 mil páginas no total, incluindo discussões e redirecionamentos
- Desde 2006, mais de 86 mil editores realizaram mais de 840 mil edições, com mais de 2 mil edições mensais e cerca de 300 contribuidores ativos
Pontos fortes da ArchWiki
- Fornece conteúdo abrangente sobre uma grande variedade de temas e ampla cobertura documental
- Mantém atualizações em tempo real, sempre refletindo o estado atual dos pacotes e da distribuição
- Há forte participação de colaboradores comuns além da equipe de manutenção, com crescimento baseado na comunidade
- Um grande diferencial é sua escalabilidade, servindo de referência para todos os usuários de Linux, indo além da comunidade Arch
- Sua estrutura documental é concisa e clara, o que favorece muito a busca por informações
Diretrizes de contribuição e conteúdo
- Existem três princípios principais de edição
- Após toda alteração, o resumo de edição é obrigatório
- Modificações complexas devem ser feitas de forma atômica e gradual
- Alterações importantes devem ser avisadas previamente na página de discussão para colher opiniões
- No aspecto de conteúdo
- O princípio DRY (Do not repeat yourself) é aplicado com rigor
- Os documentos permanecem simples, mas incentivando exploração autônoma
- Informações não verificadas com base no Arch não são aceitas, e o conteúdo é mantido alinhado ao Arch
Manutenção e gestão da comunidade
- Existem diversos templates e ferramentas de automação para ajudar na administração, revisão e categorização
- Qualquer pessoa pode participar do processo de revisão, mas a verificação prática costuma ser conduzida por usuários interessados em cada tema
- Erros ou problemas podem ser imediatamente marcados com templates de sinalização
- Em edições duvidosas ou controversas, busca-se reunir a opinião da maioria, com forte foco em prevenir conflitos de edição
- Ao pedir ajuda em fóruns ou no IRC, os usuários são sempre encaminhados à wiki, e, quando necessário, são incentivados a criar novo conteúdo
Pontos fracos da ArchWiki
- A sintaxe complexa (markup do MediaWiki) e as diretrizes funcionam como barreira de entrada para novos contribuidores
- Regras estruturais como o princípio DRY são difíceis de entender e aplicar para iniciantes
- A própria plataforma MediaWiki foi desenvolvida com foco na Wikipedia e entra em conflito em alguns pontos com as necessidades do Arch, limitando customizações
- A sintaxe é peculiar e difícil de interpretar, o que fragiliza manutenção e automação
- Por ser um sistema voluntário baseado em popularidade, há viés nas atualizações de conteúdo e inconsistência na renovação das informações
Oportunidades e ameaças
- Há potencial de expansão por meio da comunidade e da conexão com distribuições derivadas do Arch
- Ferramentas auxiliares para contribuidores, como wiki-scripts (Python) e Wiki Monkey (JavaScript), podem ser aproveitadas
- No futuro, está sendo explorada a possibilidade de introduzir verificação ortográfica (lint) ou suporte de IA (embora seja preciso considerar a queda de qualidade causada por conteúdo de IA não verificado e problemas com bots de scraping)
- Recentemente, contribuições com uso de IA não se alinharam às diretrizes e causaram problemas
- No longo prazo, a questão de esgotamento dos contribuidores (burnout) exige entrada contínua de novas pessoas
Outras informações operacionais e discussão
- Há uma sala de chat dedicada, #archlinux-wiki (Libera.Chat), e as discussões são direcionadas para as páginas Talk da própria wiki
- A equipe de administração tem entre 30 e 50 pessoas, e a infraestrutura é baseada em uma única máquina virtual na nuvem
- Sobre a escolha do MediaWiki novamente, se forem necessários plugins e API, MediaWiki é a opção; caso contrário, soluções baseadas em Markdown também são consideradas
- Foi observado um forte aumento de atividade durante a pandemia de COVID e um declínio contínuo depois disso, levando à busca por uma possível retomada com nova arquitetura ou integração com distribuições derivadas
Impacto no projeto Debian
- Logo após a apresentação da ArchWiki, o Debian iniciou o projeto de reformulação (Revamp) da wiki
- Foi decidida a substituição do antigo MoinMoin por MediaWiki
- Foram abertos uma nova wiki oficial (beta) e a mailing list debian-wiki
- Após 24 de julho de 2025, o novo conteúdo da wiki passou a usar a licença CC BY-SA 4.0
- Se o ritmo de melhorias continuar, espera-se que a wiki do Debian alcance uma qualidade comparável à da ArchWiki
- A perspectiva é de um círculo virtuoso, com expansão de um repositório de conhecimento open source escalável e confiável para todos os usuários de Linux
Conclusão
- O modelo da ArchWiki é reconhecido, além da distribuição em si, como um bom exemplo de documentação colaborativa para toda a comunidade Linux/open source
- Essa interação com o Debian simboliza o movimento de disseminação e padronização de conhecimento e know-how dentro do ecossistema open source
1 comentários
Comentários no Hacker News
Acho que a Arch wiki é um dos melhores resultados já produzidos pela comunidade Linux
Parece uma espécie de TLDP moderno e melhorado
Na prática, quase nunca usei Arch de fato, mas a Arch wiki já me ajudou muito em vários contextos, como workstations, servidores e sistemas customizados baseados em Yocto
A Arch wiki cobre amplamente diferentes abordagens, então é bem provável encontrar um guia relevante para qualquer ferramenta
Como a Arch faz poucas mudanças em relação ao upstream, na maioria dos casos as explicações continuam válidas até para outras distribuições
Claro, às vezes é preciso separar casos especiais, como situações específicas do Debian, mas se você tem familiaridade com Linux, frequentemente percebe que a Arch wiki é a melhor documentação
Mesmo antes de usar Arch, quando eu pesquisava no Google sobre situações ambíguas no Ubuntu, sempre acabava encontrando na Arch wiki alguma orientação do tipo “usuários de Ubuntu resolvem assim”
Isso aconteceu várias vezes
Lendo isso, lembrei que no começo do Gentoo as pessoas também falavam coisas parecidas sobre a documentação do Gentoo
Depois de usar FreeBSD e OpenBSD, dá para perceber o quanto a documentação do Linux é relativamente fraca
Nos sistemas BSD, comandos, programas, system calls e arquivos de configuração são todos documentados de forma rigorosa em páginas man e guias
Em especial, o FreeBSD Handbook é um verdadeiro tesouro
A barreira de entrada do sistema operacional é relativamente alta, mas a documentação compensa totalmente essa desvantagem
Em vez de criar várias wikis separadas com 80% de informação duplicada, seria ótimo ter uma wiki genérica que pudesse ser diferenciada por distribuição
Antigamente o Gentoo também tinha uma wiki incrível, mas, se lembro bem, ela se perdeu há mais de 10 anos por falha em um array de discos
Como hoje todo mundo acaba recorrendo à Arch wiki, às vezes penso se não valeria transformar a archwiki em um projeto compartilhado
No fim, o que importa para fazer uma boa wiki são pessoas e políticas
Wikis pequenas são ótimas porque deixam subir praticamente qualquer coisa, mas o nível de conteúdo e de atualização varia muito de página para página
Quando há muitas contribuições, os editores passam a ter dificuldade para dar conta, e informações não verificadas se acumulam até a wiki perder credibilidade
Por outro lado, se a edição é rígida demais, a informação envelhece, fica conservadora e o lugar perde a graça
No fim, é uma vantagem existirem várias wikis com direcionamentos diferentes
Mesmo que as pessoas ou as políticas de um lugar entrem em colapso, ainda há alternativas
Se concentrar tudo em um só lugar, por ser trabalho voluntário, muita gente provavelmente vai desistir
A Wikipédia é um caso excepcional de sucesso; no resto, acho mais natural que as coisas fiquem espalhadas
Criar várias wikis redundantes é ao mesmo tempo um ponto forte e uma fraqueza do ecossistema Linux
Assim como já existem muitos ambientes desktop e ainda surgem outros, e o mesmo vale para gerenciadores de pacotes, a existência de várias wikis também é um fenômeno natural no mundo Linux
Comparação de ambientes desktop, Lista de sistemas de gerenciamento de pacotes, Ranking de popularidade de distribuições
O motivo de uma wiki genérica não ter surgido naturalmente é, em geral, que cada distribuição começa documentando apenas suas partes específicas e, aos poucos, adiciona também conteúdo mais geral, mas no fim tudo continua baseado em documentação própria de cada projeto, então há pouca disposição para compartilhar
Com o tempo, quando alguma wiki cresce com sucesso, ela acaba se estabelecendo silenciosamente como um padrão
Há 25 anos, wikis eram algo novo e livre, então havia mais entusiasmo em compartilhar conteúdo, mas com o passar do tempo cada grupo foi seguindo sua própria direção e o compartilhamento foi se desfazendo
Mais recentemente, houve um movimento parecido em comunidades de gestão de conhecimento baseadas em Markdown, mas sem grandes resultados
Na prática, compartilhar informação é bem mais difícil do que parece
Antigamente havia uma pequena wiki de visão computacional que era bastante útil, e por volta de 2010 decidiram migrar o conteúdo para a Wikipedia
O resultado foi exatamente o esperado
A wiki original desapareceu, só uma parte sobreviveu, e na Wikipedia o conteúdo não permaneceu de forma adequada
No fim, foi a experiência de perder um excelente recurso
Em uma wiki com escopo amplo demais, fica difícil perceber quando determinado conteúdo ficou velho ou deixou de ser útil
Limitar claramente o tema, como faz a Archwiki, ajuda a evitar o acúmulo de práticas ultrapassadas e a preservar a qualidade
Sempre fico impressionado com o nível de acabamento da Archwiki
Só consegui entender systemd direito depois de ler um excelente artigo sobre o tema
Quando vi um link explicando por que os mantenedores do Arch migraram a distribuição para systemd, consegui aceitar a mudança
Quando comecei no Linux, usei Fedora e Ubuntu, mas sempre encontrava na Arch wiki as respostas para as minhas dúvidas
Então acabei simplesmente migrando para Arch
Naquela época, bastava pesquisar que a Arch wiki sempre aparecia no topo, mas faz tempo que não a vejo nos resultados de busca
No meu caso também, quando tentei instalar Linux em um macbook, a Arch wiki foi a única que trouxe informação suficiente
Por isso, esse foi o principal motivo que me levou a experimentar Arch de fato
Será que esse artigo sobre systemd é este link?
Daqui para frente, pretendo dedicar mais esforço a editar a wiki do que a escrever posts para a comunidade
A wiki e os pacotes são justamente os pontos fortes do Arch
Bons resultados assim só existem graças a um trabalho colaborativo muito manual
Além disso, apagar coisas ou não aceitar mudanças também não é fácil, mas é um processo necessário para manter a legibilidade da wiki
Espero que o conhecimento tratado no Arch também consiga chegar bem ao lado do NixOS
Olhando o gráfico de usuários ativos mensais da ArchWiki, parece que a tendência de queda começou em 2013
Tirando o período de lockdown, o gráfico segue em uma descida em degraus
Fico curioso para saber o que aconteceu
Por volta de 2012, com o início da migração para systemd, houve necessidade de atualizar muitas páginas em grande escala
Depois disso, voltou a um nível normal
Mais recentemente, o NixOS também deve ter absorvido parte dos usuários mais entusiastas
Antigamente o Arch tinha a imagem de ser uma distribuição “nada amigável, usada por profissionais”
Mas na prática ele era mais fácil de usar do que parecia, e daí nasceu o meme “I use Arch btw”
Parece que muitos desses usuários recentemente migraram para o NixOS
2013 foi o ano em que o Manjaro começou a ganhar popularidade
O Arch já tinha até fechado os fóruns em 2011 por causa da popularidade
Link de referência
Acho que também pode ser porque a maior parte das informações importantes já foi organizada, então sobrou menos coisa nova para escrever
Um dos recursos que eu mais queria na Arch wiki era poder ocultar seções de acordo com condições
Os guias apresentam várias opções, mas, dependendo da escolha feita, partes posteriores deixam de fazer sentido
Seria útil ter um recurso em que, ao marcar uma escolha específica, as seções irrelevantes mais adiante pudessem ser ocultadas
Fico na dúvida se é correto compartilhar no Hacker News links do lwn.net destinados a assinantes
Tenho receio de que isso possa prejudicar a LWN
Fui conferir o FAQ oficial e está explicitamente dito que links de assinante podem ser compartilhados praticamente em qualquer lugar
Eles dizem que recebem bem esse compartilhamento “desde que não atrapalhe as tentativas de conquistar mais assinantes”
Link do FAQ
Compartilhar ocasionalmente esses links de assinante dessa forma pode até ter um efeito positivo
Se o conteúdo for bom, a expectativa é que as pessoas assinem para apoiar a produção de mais conteúdo
Na prática, já assinei a LWN justamente por causa de artigos de alto nível como esses
Normalmente isso é compartilhado pelo botão de “shared link”
Não precisa fazer login, mas outros recursos exclusivos de assinante continuam restritos a assinantes
Ainda assim, é curioso esse status de conteúdo de assinante
Como aparece na tela a mensagem “The following subscriber-only content was made available by an LWN subscriber”, fica claro que esse é um recurso intencional
A Arch wiki é para o Linux algo como a documentação do PostgreSQL
Mesmo sem usar diretamente Arch ou Postgres, ela serve como um ótimo ponto de partida para entender a estrutura e o modo de uso, e traz informação suficiente para permitir inferências
Um dos motivos mais importantes para eu usar Arch é justamente a wiki
Não adianta uma funcionalidade ser boa se ninguém souber que ela existe
Gosto especialmente de partes como a seção de “why” em cada método, explicando por que se deve fazer determinada escolha
Um bom exemplo é a página sobre data-at-rest encryption
Página de data-at-rest encryption