Comemoração dos 20 anos do MDN

• O MDN Web Docs completa 20 anos e apresenta a tradição do bolo de aniversário na indústria web
• Existe uma tradição em que fabricantes de navegadores enviam bolos uns aos outros em marcos importantes para celebrar a cooperação em meio à concorrência
• Neste aniversário do MDN, a comemoração veio com um bolo de presente da equipe do web.dev
• O desenvolvimento do MDN teve como peça-chave o esforço da comunidade global e de mais de 100 mil contribuidores
• Também reforça o esforço em direção ao objetivo comum de capacitar desenvolvedores e construir uma web melhor

---

Comemoração dos 20 anos do MDN Web Docs

A tradição do bolo na indústria web

• No ecossistema web, o bolo de aniversário tem um significado especial
• As empresas que desenvolvem navegadores mantêm a tradição de presentear umas às outras com bolos sempre que celebram grandes lançamentos de produtos ou marcos importantes
  • A Microsoft chegou a enviar bolos para a Mozilla nos lançamentos do Firefox 2, 3 e 4
  • A Mozilla também já enviou um bolo para a Microsoft no lançamento do IE10
• Essa tradição é um símbolo que mostra bem a cultura de desenvolvimento web em que competição e colaboração coexistem

O bolo do 20º aniversário do MDN

• No 20º aniversário do MDN, eles receberam um bolo de comemoração da equipe do web.dev
• A equipe do MDN agradeceu à equipe do web.dev pelo delicioso bolo e também a todos os parceiros, colegas e membros da comunidade que fizeram o MDN chegar até aqui

A comunidade do MDN e a parceria global

• O crescimento do MDN contou fortemente com a atuação de inúmeros desenvolvedores e mais de 100 mil contribuidores
• Embora muitos membros não tenham podido ser mencionados individualmente, o MDN pôde crescer graças à paixão, curiosidade e contribuições diretas dessas pessoas

Compromisso para o futuro

• A equipe do MDN reforça o objetivo de fortalecer desenvolvedores no mundo todo e construir uma web melhor em conjunto
• Com base na experiência dos últimos 20 anos, espera manter o mesmo objetivo pelos próximos 20, com colaboração e crescimento contínuos

[GN⁺]

Comentários do Hacker News

• O MDN é claramente uma referência importante. Documentar tecnologias web modernas tão complexas não é uma tarefa fácil, e eles fizeram isso muito bem. Mas tenho duas pequenas ressalvas. Primeiro, às vezes leio coisas um pouco duvidosas no MDN. Por exemplo, os tutoriais sobre frameworks e bibliotecas JavaScript não me parecem oferecer um valor especial em comparação com os tutoriais oficiais. Em especial, o tutorial de Svelte tem 5 anos e não combina com a realidade atual. Segundo, é uma pena que a qualidade da documentação de webextension seja fraca. A maior parte é baseada no manifest v2, e o conteúdo sobre v3 ou compatibilidade com Chrome é mencionado de forma incompleta. Na prática, enquanto desenvolvia com essa documentação, acabei tendo que migrar para a documentação oficial do Chrome. E isso mesmo tendo Firefox como alvo principal
  • Faço parte da equipe do MDN. Muito obrigado pelos elogios e pelo feedback! Vou compartilhar esses pontos com a equipe. Se quiser aprender mais sobre como criar extensões para o Firefox, talvez valha a pena consultar extensionworkshop.com
  • Concordo fortemente com a ideia de que às vezes há conteúdo questionável no MDN. O MDN precisa sobreviver por muito mais tempo do que bibliotecas ou frameworks do lado do usuário. Fico curioso para saber se a Vercel vai encontrar uma forma de atrair usuários do MDN para o framework deles
• Fico muito feliz que o MDN ainda exista e continue sendo atualizado. Eu achava que toda a equipe tinha sido demitida em 2020, então fico curioso para saber se reconstruíram a equipe depois disso. Link para a discussão relacionada no HN
  • Faço parte da equipe do MDN. Na época, a equipe chegou a ser reduzida temporariamente a duas pessoas e alguns contratados, mas desde então crescemos bastante. Hoje, temos 15 pessoas entre funcionários fixos e contratados, além de uma ampla rede de parceiros e contribuidores que mantém o MDN atualizado. Dá para ver mais detalhes em nossa página da equipe
  • Essa situação é realmente desconcertante. A Mozilla demitiu a equipe inteira, então não entendo por que um domínio da Mozilla está celebrando o aniversário do mdn
  • Grande parte da documentação do MDN existe graças ao OpenWebDocs. É uma iniciativa mantida por voluntários e várias empresas de tecnologia. openwebdocs.org
  • Como o código é aberto, dá para verificar diretamente quem está contribuindo e como. Olhando as estatísticas de contribuidores, parece que muitos dos principais contribuidores recentes não são funcionários da Mozilla, mas gente de Yale, freelancers (talvez pagos pela Mozilla) e pessoas de várias empresas
• Graças ao MDN, consegui criar já adulto um jogo no estilo Space Invaders, que era um sonho de infância. As excelentes documentações sobre a Canvas API e o OscillatorNode tornaram muito fácil começar no desenvolvimento de jogos. Também deixo aqui o jogo que fiz e a motivação do projeto
  • A jogabilidade estava realmente ótima. Gostei do ritmo de progressão, como velocidade, quantidade de inimigos e a forma como eles descem, e foi divertido poder atirar nas balas dos inimigos. Não sei o quanto difere do Invaders original, mas foi uma experiência muito boa para uma pausa curta. Obrigado por compartilhar
  • Fico muito feliz que o MDN tenha ajudado você a realizar esse sonho! Vou repassar esse feedback para a equipe
• Há quase 20 anos eu uso o MDN como a documentação web que mais consulto. O MDN é um recurso essencial. É muito mais fácil de ler do que as especificações oficiais e ainda oferece exemplos práticos, referências cruzadas e até um playground simples. Por isso continua sendo tão útil
• Muitas vezes não é fácil aprender um recurso desconhecido no MDN. Às vezes leio a documentação e me pergunto: “afinal, para quem isso foi escrito?”. Mesmo depois de uns dois parágrafos, ainda não fica claro o que esse recurso é nem que problema ele tenta resolver. Se você não conhece bem os detalhes do tema, termina a leitura sem levar quase nada. Às vezes, olhar a especificação acaba dando mais contexto. Ainda assim, fico feliz que o MDN exista, mas gostaria que tivesse a clareza explicativa de CSS: The Definitive Guide. Passei mais de um ano sem conseguir aprender CSS pela documentação do MDN, mas depois de ler CSS: The Definitive Guide consegui entender tudo em três meses. Se existisse um sistema que mantivesse explicações nesse nível em formato de wiki, com as informações atualizadas a partir do material de referência do MDN, eu até pagaria para usar
  • Sou membro da equipe do MDN. Muito obrigado pelo excelente feedback. Vou compartilhar isso com a equipe como ponto de melhoria. Sobre a pergunta “para quem essa documentação é feita?”, a maior parte das nossas páginas de referência é construída com base em implementações reais nos navegadores. Não documentamos apenas a especificação; focamos nos recursos que já foram adotados em vários navegadores. Tentamos transmitir essas informações de forma clara e neutra, para que pessoas em qualquer etapa do desenvolvimento consigam acessá-las facilmente. Em paralelo, recentemente também temos ampliado bastante o conteúdo de aprendizado para iniciantes. Temos currículos que ajudam no crescimento em diferentes estágios da jornada de cada desenvolvedor, e temas mais aprofundados são complementados no blog
  • Há 4 ou 5 anos, alguns exemplos do MDN não funcionavam de fato nos navegadores, e a diferença entre a função e a palavra-chave fit-content era explicada de forma ambígua, então abri uma issue. Depois disso, a documentação foi corrigida. Mas agora parece que já não dá para levantar questões e pedir correções da mesma forma de antes. É preciso haver um novo canal de feedback ou processo de correção. Exemplo de issue antiga
• Acho meio estranho reclamar justamente nos comentários de comemoração de um serviço gratuito. Uso a documentação do MDN há mais de 5 anos, e ela é um recurso valiosíssimo, além de incentivar naturalmente muitos experimentos. Graças ao MDN, descobri APIs e recursos incríveis que eu nem saberia que existiam se não tivesse ido procurar. Parabéns pelos 20 anos
  • Isso me lembra a frase do Stroustrup sobre “só existem linguagens das quais as pessoas reclamam e linguagens que ninguém usa”. Como o MDN é um serviço realmente necessário, muita gente acaba tendo opiniões diversas sobre ele. Eu mexo só um pouco com a plataforma web, mas a documentação do MDN sempre me pareceu mais viva do que outras documentações
• O MDN é um recurso realmente útil. Nos últimos 15 anos, usei pelo menos uma vez por mês o comando !mdn Array no DuckDuckGo
  • A comunidade também criou o redirecionamento mdn.io/array, então você pode usar isso também!
• Fiquei curioso se existe alguma forma de apoiar financeiramente o MDN diretamente. Não quero doar para a Mozilla de forma geral, mas fazer uma doação direcionada para ser usada claramente na operação do MDN. O MDN é essencial nesse nível para mim
  • Sinto o mesmo em relação ao Firefox, do qual dependo todos os dias. Mas minha decepção com a organização Mozilla só aumenta. Fico frustrado ao ver recursos sendo desviados para coisas sem relação com o Firefox, e não pretendo fazer contribuições extras até que as prioridades voltem a se alinhar
• Uso muito bem o MDN. Se a equipe estiver lendo estes comentários, queria compartilhar que a documentação de SVG foi um pouco desconfortável para mim. As explicações dos elementos SVG pareceram superficiais demais. Por exemplo, no elemento 'g', a página de descrição não deixa claro, com links ou explicações concretas, quais atributos podem ser usados nem o que são atributos globais. Eu deveria conseguir ver facilmente a lista de atributos na página, mas preciso sair procurando, o que é incômodo. Se você clica em "attributes", aparece a lista completa de atributos, mas não fica claro quais são globais. Esse tipo de organização não me parece intuitivo, e numa documentação de estrutura de API eu esperaria que cada propriedade fosse explicada na própria página da estrutura. Como na documentação do HTMLCanvasElement, eu gostaria de ao menos ver de relance os atributos próprios de cada elemento e os herdados. Parece que boa parte disso poderia ser semi-automatizada com IDL
• Quando descobri o MDN pela primeira vez, foi como entrar escondido no depósito secreto de um mago e folhear grimórios antigos. Equipe da Mozilla, vocês fazem um trabalho incrível