Resumo

  • No plano divulgado em outubro de 2020, a Mozilla explicou que o wiki publicava uma edição de imediato e a revertia se fosse inadequada. O Yari transferia a análise para antes da alteração da página pública.
  • O anúncio de estreia de 14 de dezembro confirmou a passagem dos documentos de um banco SQL para arquivos em um repositório. O conteúdo ainda estava em HTML; página inicial, perfis e busca permaneciam na estrutura antiga em Django.

O conserto chegava antes da conversa

O velho MDN respondia a uma necessidade real. Uma referência técnica perde utilidade quando um erro conhecido continua no ar. O wiki oferecia um editor visual dentro do site; bastava mudar o trecho e salvar. A alteração se tornava pública, sujeita a reversão posterior. A Mozilla descreveu essa ordem na explicação de 29 de outubro de 2020. Ela dava agilidade a quem corrigia e entregava aos moderadores o trabalho de limpar o que não deveria ter passado.

Havia duas contas nessa operação. Uma era o spam: ele podia ser visto por leitores antes de alguém apagá-lo. A outra era a relação com quem contribuía de boa-fé. Se a mudança permanecia, a pessoa inferia que tinha sido aceita; se sumia, talvez descobrisse ao voltar à página. A Mozilla considerava ruim essa conversa feita por silêncio e reversão. A contribuição entrava no site antes que houvesse um espaço claro para discutir seu mérito.

O custo também aparecia na infraestrutura. Os documentos estavam no MySQL, e a equipe mantinha recursos de histórico, versões e comparação. Leitores e autores passavam pela mesma arquitetura. O cache de cinco minutos ajudava a exibir depressa as alterações feitas pelos autores. Segundo a Mozilla, mais de 99% do tráfego vinha de pedidos de leitura de documentos. A urgência da minoria que escrevia participava, assim, do desenho do serviço usado pela maioria que lia.

A proposta ficou visível; a página, à espera

O Yari separou essas etapas. O autor passaria a editar um arquivo no GitHub e abrir um pull request. Revisores poderiam perguntar, apontar um problema e aprovar a mudança antes da geração e da distribuição da nova página. O plano de outubro previa uma publicação diária e mirava até 48 horas da contribuição à entrada no ar no pior cenário. A cifra era uma promessa de operação, não uma medição de todas as correções após a estreia.

Para a Mozilla, a mudança concentrava vários ganhos. O debate ficava ligado ao texto proposto; correções em páginas diferentes podiam viajar juntas; verificações automáticas podiam ocorrer antes da aprovação. Uma tentativa de spam não precisava estrear no MDN para então ser removida. O conteúdo em arquivos também permitia reduzir código próprio do wiki e entregar aos leitores páginas geradas com antecedência. A revisão deixava de ser um pedido de desculpas tardio e passava a decidir a entrada.

O preço era mais perceptível na menor tarefa. O editor visual dentro da página desapareceu. O GitHub oferecia uma interface no navegador para emendas simples, sem exigir comandos de git, mas o voluntário ainda precisava lidar com um arquivo, apresentar a proposta e esperar a fusão e o deploy. E esse arquivo não era Markdown no começo: o relato de lançamento diz que o conteúdo estava em HTML. Passar a Markdown era um plano posterior.

A virada teve bordas

O teste público começou em 2 de novembro; a Mozilla anunciou o lançamento em 14 de dezembro de 2020. Alterar documentos agora significava enviar um pull request ao repositório oficial mdn/content. Nem todo o velho sistema saiu de cena: página inicial, perfis e busca ainda usavam serviços em Django. A migração mudou primeiro o caminho da documentação, não cada peça que compunha o site.

Em julho de 2021, a organização disse que contas do MDN já não serviam para contribuir. Para editar, a pessoa precisava entrar no GitHub. A desativação das contas MDN estava marcada para 22 de julho. A ferramenta escolhida para receber as propostas também passou a controlar a identidade apresentada por quem queria corrigir.

Os dois modelos aceitavam colaboradores; eles distribuíam a decisão de forma diferente. No wiki, o colaborador decidia a primeira publicação, e a Mozilla podia desfazê-la. No Yari, o colaborador mostrava a proposta e seus argumentos, enquanto os responsáveis pela revisão decidiam quando ela se tornaria a página consultada pelo público. Uma mudança pequena no trajeto de um erro alterou quem tinha a última palavra sobre a próxima resposta do MDN.