Esta tradução está incompleta. Por favor, ajude a traduzir este artigo do Inglês.
Se estiver aqui pela primeira vez ou depois de uma pesquisa avançada, provavelmente é porque está interessado em contribuir para a Área de Aprendizagem na MDN. Ótimas notícias!
Nesta página, irá encontrar tudo o que precisa para começar a ajudar a melhorar o conteúdo de aprendizagem da MDN. Existem muitas coisas que pode fazer, dependendo do tempo que tiver disponível e se é um principiante, um programador da Web, ou um professor.
Nota: pode encontrar um guia para escrever um novo artigo da área de aprendizagem em Como escrever um artigo para ajudar as pessoas a aprenderem sobre a Web.
Encontrar tarefas específicas
Uma maneira comum para contribuir na área de aprendizagem é ler os artigos, corrigir erros de digitação, e sugerir melhorias. Nós também agradecemos que adicione exemplos ao nosso repositório do GitHub, e entre em contacto connosco se quiser perguntar o que mais precisa de ser feito.
Contribuir é uma ótima maneira para se divertir enquanto aprende coisas novas. Se se sentir perdido ou tiver dúvidas, não hesite em nos contactar no tópico da Área de Aprendizagem Discourse ou canal IRC (consulte no fim desta página para detalhes). Chris Mills é o escritor técnico para a área de aprendizagem — também poderá tentar efetuar um pinging diretamente.
As secções seguintes fornecem algumas idéias gerais sobre os tipos de tarefas que pode realizar.
Eu sou um principiante
That's awesome! Beginners are very important and valuable for creating and giving feedback on learning material. You have a unique perspective on these articles as a member of their target audience, which can make you an invaluable member of our team. Indeed, if you're using one of our articles to learn something and you get stuck, or find the article confusing in some way, you can either fix it or let us know about the problem so we can be sure it gets fixed.
Here are some suggested ways you can contribute:
- Adicionar etiquetas aos seus artigoes (5 mínutos)
- Tagging MDN content is one of the easiest ways to contribute to MDN. As many of our features use tags to help present information in context, helping with tagging is a very valuable contribution. Take a look at the lists of glossary entries and learning articles without any tags to get started.
- Ler e rever uma entrada do glossário (5 mínutos)
- As a beginner, we need your fresh eyes looking at our content. If you find a glossary entry hard to understand, it means that entry needs to be improved. Feel free to make any changes you think are necessary. If you do not think you have the proper skill to edit the entry yourself, at least tell us on our mailing list.
- Criar uma nova entrada do glossário (20 mínutos)
- This is the most effective way to learn something new. Pick a concept you want to understand, and as you learn about it, write a glossary entry about it. Explaining something to others is a great way to "cement" the knowledge in your brain, and to help you make sense of things yourself, all while helping other people. Everybody wins!
- Ler e rever um artigo de aprendizagem (2 horas)
- This is very much like reviewing glossary entries (see above); it just takes more time, since these articles are typically quite a bit longer.
Eu sou um programador
Fantastic! Your technical skills are just what we need to be sure we provide technically accurate content for beginners. As this specific part of MDN is dedicated to learning the Web, be sure your explanations are as simple as possible, without being so simple that they're not useful. It's more important to be understandable than to be overly precise.
- Read and review a glossary entry (5 min)
- As a web developer, we need you to make sure our content is technically accurate without being too pedantic. Feel free to make any changes you think are necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.
- Write a new glossary entry (20 minutes)
- Clarifying technical jargon is a very good way to learn and be both technically accurate and simple. Beginners will thank you for that. We have many undefined terms which need your attention. Pick one and you're good to go.
- Read and review a learning article (2 hours)
- This is the same thing as reviewing a glossary entry (see above); it just takes a bit more time as those articles are quite a bit longer.
- Write a new learning article (4 hours or more)
- Create exercises, code samples or interactive learning tools (? hours)
- All our learning articles require what we call "active learning" materials, because people learn best by doing something themselves. Such materials are exercises or interactive content that help a user to apply and manipulate the concepts detailed in an article. There are many possible ways to make active learning content, from creating code samples with JSFiddle or similar, to building fully hackable interactive content with Thimble. Unleash your creativity!
Eu sou um professor
MDN has a long history of technical excellence, but we lack depth of understanding of the best way to teach concepts to newcomers. This is where we need you, as a teacher or educator. You can help us ensure that our materials provide a good, practical educational track for our readers.
- Read and review a glossary entry (15 min)
- Check out a glossary entry and feel free to make any changes you think are necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.
- Write a new glossary entry (1 hour)
- Clear, simple definitions of terms and basic overviews of concepts in the glossary are critical in meeting beginners' needs. Your experience as an educator can help create excellent glossary entries; we have many undefined terms which need your attention. Pick one and go for it.
- Add illustrations and/or schematics to articles (1 hour)
- As you might know, illustrations are an invaluable part of any learning content. This is something we often lack on MDN and your skills can make a difference in that area. Check out the articles that lack illustrative content and pick one you'd like to create graphics for.
- Read and review a learning article (2 hours)
- This is similar to reviewing glossary entries (see above), but it requires more time since the articles are typically quite a bit longer.
- Write a new learning article (4 hours)
- We need simple, straightforward articles about the Web ecosystem and other functional topics around it. Since these learning articles need to be educational rather than trying to literally cover everything there is to know, your experience in knowing what to cover and how will be a great asset.
- Create exercises, quizzes or interactive learning tools (? hours)
- All our learning articles require "active learning" materials. Such materials are exercises or interactive content which help a user learn to use and expand upon the concepts detailed in an article. There are lots of things you can do here, from creating quizzes to building fully hackable interactive content with Thimble. Unleash your creativity!
- Create learning pathways (? hours)
- In order to provide progressive and comprehensible tutorials, we need to shape our content into pathways. It's a way to gather existing content and figure out what is missing to create a learning article to write.