Desenvolvimento

22 mar, 2012

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

Publicidade

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 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.