Como contribuir para a √°rea de aprendizagem da MDN

Se você está aqui pela primeira vez ou após uma pesquisa mais aprofundada, é porque provavelmente você está interessado em contribuir para a área de aprendizado da MDN. Isto é uma excelente notícia!

Nesta p√°gina, voc√™ ir√° encontrar tudo o que voc√™ precisa para come√ßar a ajudar a melhorar o conte√ļdo de aprendizado da MDN. Existem muitas coisas que voc√™ pode fazer, dependendo de quanto tempo voc√™ tem dispon√≠vel ou se voc√™ √©um iniciante, um desenvolvedor web, ou um professor.

Nota: se você já é um contribuinte do MDN, não hesite em checar novamente a pagina com o status da documentação para acompanhar o trabalho que tem sido feito e ver quais prioridades estão sendo escritas.

Nota: Os contribuintes estão utilizando um painel na Trello para organizar as suas tarefas. Se você quiser utilizar esta ferramenta, apena se registre na Trello e procure por Jeremie lhe dar acesso de escrita ao painel.

Encontre tarefas específicas

Uma forma comum que as pessoas usam para contribuir para a √Ārea de aprendizado √© lendo os artigos, corrigindo erros de digita√ß√£o e sugerindo melhorias. Adi√ß√£o de exemplos no nosso reposit√≥rio do github tamb√©m √© bem vindo e entre em contato conosco se voc√™ quiser pedir o que mais precisar.

Contribuir √© um √≥timo modo de se divertir enquanto aprende novas coisas. Se voc√™ se sentir perdido ou tiver d√ļvidas, n√£o hesite em chegar at√© n√≥s no "F√≥rum de conversa e aprendizado" ou no canal IRC (Veja o final da p√°gina para mais detalhes). Chris Mills √© o "topic driver" da √Ārea de aprendizado - voc√™ tamb√©m poderia tentar contat√°-lo diretamente.

As sess√Ķes a seguir oferecem algumas ideias gerais de tipos de tarefas que voc√™ pode fazer.

Eu sou um iniciante

Isto √© incr√≠vel!  Iniciantes s√£o muito importantes e valiosos para criar e dar feedback sobre o material de aprendizado. Voc√™ possui uma perspectiva √ļnica destes artigos j√° que voc√™ faz parte do p√ļblico alvo, o que pode torna-lo um membro valioso da nossa equipe. De fato, se voc√™ est√° utilizando um dos nossos artigos para aprender algo e voc√™ ficar preso, ou de alguma forma achar o artigo confuso, voc√™ pode consertar isso ou nos contar sobre o problema para n√≥s nos certificarmos que isso ser√° corrigido.

Contribuir também é uma ótima maneira de se divertir enquanto aprende coisas novas se você se sentir perdido ou tiver perguntas, não hesite em nos contatar na nossa lista de e-mail ou no nosso canal IRC (obtenha detalhes na parte inferior desta página).

Aqui temos algumas sugest√Ķes de como voc√™ pode contribuir:

Adicionar tags para os nossos artigos (5 min)
Adicionar tags para o conte√ļdo do MDN √© uma das maneiras mais f√°ceis de contribuir para a MDN. Uma de nossas diversas caracter√≠sticas √© utilizar tags para ajudar no contexto da informa√ß√£o, √© muito valioso contribuir com as tags. Para come√ßar, d√™ uma olhada nesta lista de entradas do glos√°rio e artigos de aprendizagem sem nenhuma tag.
Escrever e revisar entradas no gloss√°rio (15 min)
Como um iniciante, precisamos dos seus olhos ainda frescos olhando para o nosso conte√ļdo. Se voc√™ achar a entrada no gloss√°rio dif√≠cil de compreender, isto significa que est√° entrada precisa ser melhorada. Sinta-se livre para fazer qualquer mudan√ßa que voc√™ ache necess√°ria. Se voc√™ acredita n√£o ter a habilidade necess√°ria para editar a entrada por voc√™ mesmo, nos comunique atrav√©s da nossa lista de e-mail.
Escrever uma nova entrada no gloss√°rio (1 horas)
Esta é a maneira mais efetiva de aprender algo novo. Pegue um conceito sobre o qual você deseja aprender, e conforme você aprende sobre ele, escreva uma entrada no glossário. Explicar algo para os outros é uma ótima maneira de consolidar o conhecimento no seu cérebro, e ajudar para que as coisas possam fazer mais sentido para você, tudo enquanto ajuda outras pessoas. Todo mundo ganha!.
Ler e revisar um artigo de aprendizagem (2 horas)
√Č muito parecido com revisar entradas no gloss√°rio (veja acima); apenas leva mais tempo, geralmente estes artigos s√£o um pouco maiores.

Eu sou um desenvolvedor web

Fant√°stico! Suas habilidades t√©cnicas s√£o tudo o que n√≥s precisamos para certeza que fornecemos um conte√ļdo preciso para os iniciantes. Como esta parte espec√≠fica do MDN √© dedicada √† aprendizagem da Web, certifique-se que as suas explica√ß√Ķes s√£o as mais simples poss√≠veis, simples, por√©m √ļteis. √Č mais importante ser compreens√≠vel do que ser excessivamente precisa.

Escrever e revisar entradas no gloss√°rio (15 min)
Como um desenvolvedor web, n√≥s precisamos de voc√™ tenha certeza que o nosso conte√ļdo √© tecnicamente preciso, sem ser muito tedioso. Sinta-se livre para fazer qualquer mudan√ßa que voc√™ achar necess√°rio. Se voc√™ quiser discutir o conte√ļdo antes da edi√ß√£o, nos contate na nossa lista de e-mail ou canal IRC.
Escrever uma nova entrada no gloss√°rio (1 hora)
Esclarecer termos técnicos é uma boa forma de aprender e ser ao mesmo tempo tecnicamente preciso e simples. Os iniciantes vão agradecer por isso. Nós temos muitos termos indefinidos que precisam da sua atenção. Pegue um e você já estará pronto para começar.
Escrever e revisar artigos de prendizagem (2 hora)
Esta é a mesma coisa que revisar uma entrada do glossário (ver acima); ela só leva um pouco mais de tempo pois estes artigos são um pouco maiores.
Escrever um novo artigo de aprendizagem (4 horas)
A MDN est√° em falta de alguns artigos simples sobre o uso de tecnologias web (HTML, CSS, JavaScript, etc). Temos tamb√©m alguns conte√ļdos antigos na MDN que merecem ser revisados e reformulados. Leve as suas habilidades ao limite para tornar as tecnologias da Web utiliz√°veis mesmo para os iniciantes.
Criar exercícios, exemplos de código e ferramentas de aprendizagem interativas (? horas)
Todos os nossos artigos de aprendizagem exigem que chamamos de "aprendizagem ativa", porque as pessoas aprendem melhor fazendo algo por si mesmas. Tais materiais s√£o exerc√≠cios ou conte√ļdos interativos que ajudam o usu√°rio a aplicar e manipular os conceitos descritos em um artigo. H√° muitas formas poss√≠veis de tornar os conte√ļdos de aprendizagem interativos, desde a cria√ß√£o de amostras de c√≥digo com JSFiddle, ou similar, liberte a sua criatividade para a constru√ß√£o de conte√ļdo interativo com Thimble.

Eu sou um professor

A MDN tem uma longa história de excelência técnica, mas falta profundidade de compreensão da melhor maneira de ensinar conceitos para os recém-chegados. E é aqui que precisamos de você, como um professor ou educador. Você pode nos ajudar a garantir que os nossos materiais possuam uma boa didática, e que sejam práticos para os nossos leitores.

Ler e revisar uma entrada no gloss√°rio (15 min)
Confira uma entrada de gloss√°rio e sinta-se livre para fazer qualquer altera√ß√£o que voc√™ ache necess√°ria. Se voc√™ quiser discutir sobre o conte√ļdo antes da edi√ß√£o, entre em contato conosco na nossa lista de e-mail ou canal IRC.
Escrever uma nova entrada no gloss√°rio  (1 hora)
Defini√ß√Ķes claras, simples de termos e conceitos b√°sicos no gloss√°rio s√£o fundamentais para atender √†s necessidades dos iniciantes. Sua experi√™ncia como educador pode ajudar a criar excelentes entradas de gloss√°rio; temos muitos termos indefinidos que precisam da sua aten√ß√£o. Escolha um e v√° a diante.
Adicionar ilustra√ß√Ķes/ou esquemas para os artigos (1 hora)
Como voc√™ deve saber, as ilustra√ß√Ķes s√£o uma parte valiosa de qualquer conte√ļdo de aprendizagem. Isso √© algo que muitas vezes n√£o temos na MDN e suas habilidades podem fazer a diferen√ßa nessa √°rea. Confira os artigos que necessitam conte√ļdo ilustrativo e pegue um que voc√™ queira criar gr√°ficos.
Ler e revisar um artigo de aprendizagem (2 horas)
Isto é semelhante a revisar entradas de glossário (veja acima), mas exige mais tempo porque os artigos são um pouco maiores.
Escrever um novo artigo de aprendizagem (4 horas)
Precisamos de artigos simples e diretos sobre o ecossistema da Web e outros temas funcionais em torno deste tema. Uma vez que estes artigos de aprendizagem precisam ser educativos ao invés de tentar literalmente cobrir tudo que há para saber, sua experiência em saber o que cobrir será um grande trunfo.
Criar exercícios, questionários e ferramentas interativas de aprendizado (? horas)
Todos os nossos artigos de aprendizagem exigem "aprendizagem ativa". Tais materiais s√£o exerc√≠cios ou conte√ļdo interativo que ajudam ao usu√°rio aprender a usar e expandir os conceitos descritos em um artigo. H√° muitas coisas que voc√™ pode fazer aqui, voc√™ pode ciar question√°rios para a constru√ß√£o de conte√ļdo interativo com o Thimble. Solte a sua criatividade!
Criar planos de aprendizagem (? horas)
A fim de fornecer tutoriais compreens√≠veis, precisamos moldar o nosso conte√ļdo em planos de aprendizagem. Esta √© uma maneira de reunir o conte√ļdo existente e descobrir o que est√° faltando para criar um bom artigo de aprendizagem.