NOTÍCIA

MDN quer aprimorar sua documentação da Open Web com a ajuda de desenvolvedores

De acordo com Jean-Yves Perrier, da Mozilla Developer Network, a organização está trabalhando para escrever a melhor documentação sobre a Open Web. Ele afirmou que a tarefa é bastante trabalhosa, e ressaltou que o JacaScript já é considerado um excelente recurso, que a sua referência CSS↳CSS31 conteúdosArquitetura CSS: CSS FuncionalDev (Back & Front) · set 2019Entendendo posicionamento com CSS de uma vez por todasDev (Back & Front) · jul 2025Sites que combinam estética e usabilidade: reflexos da evolução do CSSDev (Back & Front) · fev 2025Ver tudo em Dev (Back & Front) → já está em bom estado e que ainda há muito trabalho a ser feito em relação à sua documentação HTML, SVG e MathML.

A Open Web da MDN é voltada para desenvolvedores web. Para isso, a organização segue vários princípios, entre os quais estão:

  • desenvolvedores constroem sites para todos, e não para um navegador específico. Por isso é que, há cerca de um ano, a MDN começou a trabalhar em sua própria documentação independentemente do navegador. Apesar de ela estar longe estar concluída, um grande progresso já foi feito. 
  • a documentação precisa ser prática e relatar a web de hoje. Sendo assim, os artigos da organização são baseados no que dizem os padrões, estejam eles completos ou ainda em desenvolvimento.
  • a documentação é feita sob medida para desenvolvedores de diferentes níveis. Assim, a MDN fornece tutoriais para iniciantes, artigos mais descritivos para usuários intermediários e artigos de referência para desenvolvedores maduros.
  • a documentação é mantida atualizada. Para isso, a organização segue o desenvolvimento dos padrões diariamente, assim como implementações e melhorias.

Perrier enfatiza a importância da contribuição dos desenvolvedores com a MDN, e a melhor forma de ajudar, segundo ele, é linkar a organização nos blogs deles. Dessa forma, a MDN ganhará mais exposição e, consequentemente, mais editores, o que ajudará a organização a alcançar sua meta de oferecer uma documentação precisa e completa sobre a Open Web.

Para fazer isso de forma eficiente, eles escreveram um pequeno guia para dar dicas e informações aos desenvolvedores sobre como linkar para a MDN de forma pertinente. Esse guia está disponível aqui.

Matérias especiais e reportagens conduzidas internamente pela Redação iMasters. Acompanhe no Twitter @imasters e no Instagram/Threads @portalimasters

Mais de Redação iMasters
Ver perfil →