Come contribuire nell'area di MDN dedicata all'apprendimento

Se sei qui per la prima volta o dopo un'approfondita ricerca, probabilmente sei interessato nel contribuire nell'area di MDN dedicata all'apprendimento. Questa è una grande notizia!

In questa pagina, troverai tutti gli strumenti utili per iniziare a migliorare i contenuti dedicati di MDN. Ci sono molte cose che puoi fare, dipende dal tempo a tua disposizione e dal tuo essere un principiante, uno sviluppatore web o un insegnante.

Trova un compito specifico

I contributori stanno utilizzando una bacheca Trello per organizzare i propri compiti. In questo modo puoi trovare dei compiti specifici da fare nel progetto. Per essere coinvolto, basta creare un account Trello e avvisare Chris Mills per ricevere i permessi di scrittura sulla bacheca.

Contribuire è il modo migliore per divertirsi, imparando nuove cose. Se ti senti perso o hai domande, non esitare a raggiungerci nella nostra lista email o canale IRC (dettagli a fine pagina). Chris Mills guida gli argomenti per l'area apprendimento — Puoi anche contattarlo direttamente.

La seguente sezione fornisce delle idee generali di compiti che puoi fare.

Sono un principiante

Questo è meraviglioso! I principianti sono molto importanti e valorizzabili nella creazione e ottenimento di feedback sul materiale didattico. Riesci ad avere un prospettiva unica su questi articoli come tutti i membri di questa tipologia di pubblico, questo ti rende un membro fondamentale per il nostro team. Invece, se stai utilizzando i nostri articoli per imparare qualcosa e ti trovi in difficoltà, o trovi un articolo caotico, puoi sia correggerlo oppure farci sapere del problema affinché noi possiamo correggerlo.

Di seguito sono riportati i modi con cui puoi contribuire:

Add tags to our articles (5 min)

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.

Read and review a glossary entry (5 min)

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

Write a new glossary entry (20 minutes)

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!

Read and review a learning article (2 hours)

This is very much like reviewing glossary entries (see above); it just takes more time, since these articles are typically quite a bit longer.

Sono uno sviluppatore

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 change you think is 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)

MDN is lacking simple straightforward articles about using web technologies (HTML, CSS, JavaScript, etc). We also have old content on MDN that deserves to be reviewed and reshaped. Push your skills to the limit to make web technologies usable even by beginners.

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!

Sono un insegnante

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.