We're looking for a person or people to help audit MDN to find places we could speed up. Is this you or someone you know? Check out the RFP: https://mzl.la/2IHcMiE

There was a scripting error on this page. While it is being addressed by site editors, you can view partial content below.

This page tries to track ongoing documentation work in the MDN Learn section.


{{ DocStatus }}

How to contribute

The learning area on MDN is brand new and offer a lot of opportunities for contribution from small tasks to large ones. Here's a list of all what you can do to help.

Writing learning articles

Expected time: A few hours

This is the core of the Learning Area. Those article are self teaching material which details a given skills to learn. A learning article focus on a single topic to learn and follow a strict structure which include. Read "Write an article to help learn about the Web" to learn how to structure such an article.

As an example, you can be inspired by the "Understanding URLs and their structure" article. See the Writing priorities section to know what is needed.

Creating "Active learning" material

Expected time: A few days

A TextBook article always need to be linked to some Active Learning materials. Those are projects, exercises, interactive code samples or everything that allows the reader to interact with a topic details into a TextBook. Such learning material is as important as any TextBook.

To create such Active Learning material, you are free to use any tools you wish. Nonetheless we strongly encourage you to use the WebMaker tools (especially Thimble) to do so as it provides various features very helpful for beginners and allows anyone to remix any content to learn from.

Creating learning pathways

Expected time: From a few hours to a few days

We also call them "learning tutorials". A learning pathways, explain how to complete a task and will link to all the necessary TextBook articles. As it is a pathways, it will also tell in which order the various TextBook need to be read to be able to complete the task. This is the backbone of the Learning Area as it provides guidance on what to learn first to do something.

Improve the glossary

Expected time: From a few minutes to a few hours

Our glossary is one of the key element for the Learning Area, see its dedicated doc status page for details on how to contribute.

Handle tagging

Expected time: From a few minutes to a few hours

Tagging is very important on the Learning Area. We should not have pages without tags. At minimum, a page in the Learning Area should have two tags:

Making editorial and technical review is also important. Remember that it's more important to be understood than to be technically perfect.

Get involved

Want to do more? Great, any one who wants to get involved with this project is welcome. Everything is discussed directly on MDN discussion forum.

Chris Mills is the resource leading this project; feel free to contact him with any questions. He's available, for sure, on IRC  (UK time) on the various MDN channels (#mdn, #mdndev) and more.



The overall goals of the project are:

  • Improve the discoverability of beginner contents: We have some existing contents but it is pretty hard to find. We need to organize it in a better way for beginners.
  • Improve the quantity of beginner contents: While writing we mainly focus on average and advanced users. As a consequence, we lack some serious beginner oriented contents. We need to write those missing contents and organize them with the existing contents to make easier for everybody to access and contribute to them.
  • Improve the quality of beginner contents: Still, we have some existing content for beginners but we need to organize it, complete it and make it more appealing.
  • Make sure beginners are taught well during their journey to the Web: MDN is not the only resource out there to learn the Web. Beyond our own contents, it's part of the Mozilla mission to help discover and found useful good resources to learn about the web.

Success metrics

In order to get some rational measurement about the success of our actions, the following metrics are suggested:

  • Measure the increase number of unique visitors on beginner contents:
    That would be a good sign that our beginner contents is easier to reach. For 2015, we expect to get 580 000 unique visitors to our Learn zone and Glossary by the end of the year.
  • Measure the increase number of returning visitors on beginner contents:
    That would be a good sign that the beginners content is appealing for them.
  • Measure the increase of time per page on the beginners content:
    That would be a sign that more beginners read and learn from that content.
  • Measure the decrease of bounce rate on the beginners content:
    That would be a sign that more beginners read and learn more from content on MDN
  • Measure bounce to third party resources we selected:
    That would be the sign that more users trust MDN as a reliable source of information regarding third party content.
  • Measure the increase of incoming links to MDN beginner contents:
    That would be the sign that MDN is considered as a trustable resource for beginners.

In addition, we should try to gather direct feedback on the improvements which are to be made.

Current available metrics are available on WikiMo.

Note: This project is action-driven, not time-driven. This means that we will do what needs to be done to create this content, regardless of how long it takes. However, to avoid being bogged down in this project forever, it is broken down into small, actionable steps which let us measure progress frequently.

Project status


2014 Archives

Status reports


Existing third party content

These web sites are potential sources of inspiration when creating content for new Web developers.

Help the 'Learn' documentation project…
Topic driver : Jeremie Patonnier (IRC nickname: Jeremie)
Look at the current status of the 'Learn' documentation.
Don't hesitate to contact us on #mdn or on the MDN discourse group/list:

Document Tags and Contributors

 Contributors to this page: jswisher, chrisdavidmills, Jeremie, fscholz, SphinxKnight, klez, kklein
 Last updated by: jswisher,