{"id":1698,"date":"2014-05-05T10:00:33","date_gmt":"2014-05-05T10:00:33","guid":{"rendered":"http:\/\/blog.mozilla.org\/community\/?p=1698"},"modified":"2014-05-05T15:58:04","modified_gmt":"2014-05-05T15:58:04","slug":"let-s-make-mdn-beginners-friendly","status":"publish","type":"post","link":"https:\/\/blog.mozilla.org\/community\/2014\/05\/05\/let-s-make-mdn-beginners-friendly\/","title":{"rendered":"Let&#8217;s make MDN beginner friendly"},"content":{"rendered":"<p>Since the beginning of the year, the MDN community has been\u00a0working on a very exciting project: building a learning area to make MDN friendly for beginners.<\/p>\n<div id=\"attachment_1714\" style=\"width: 610px\" class=\"wp-caption alignnone\"><a href=\"https:\/\/www.flickr.com\/photos\/fallenpegasus\/3988152150\"><img aria-describedby=\"caption-attachment-1714\" decoding=\"async\" loading=\"lazy\" class=\"size-large wp-image-1714\" src=\"https:\/\/blog.mozilla.org\/community\/files\/2014\/05\/cubes-600x148.jpg\" alt=\"https:\/\/www.flickr.com\/photos\/fallenpegasus\/3988152150\" width=\"600\" height=\"148\" srcset=\"https:\/\/blog.mozilla.org\/community\/files\/2014\/05\/cubes-600x148.jpg 600w, https:\/\/blog.mozilla.org\/community\/files\/2014\/05\/cubes-252x62.jpg 252w, https:\/\/blog.mozilla.org\/community\/files\/2014\/05\/cubes.jpg 1200w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/a><p id=\"caption-attachment-1714\" class=\"wp-caption-text\">\u00a9 Mark Atwood<\/p><\/div>\n<p>As you probably\u00a0know, <a title=\"Mozilla Developer Network\" href=\"https:\/\/developer.mozilla.org\">MDN<\/a> is a very well known and highly rated resource for general documentation about web technologies. Years of effort from the astonishing Mozilla community have produced a site that is among\u00a0best reference documentation ever about web technologies. We cover a crazy amount of technologies, in more than 11,000 articles.\u00a0Even better, we are doing this in more than 36 languages, making it available to a larger audience than just English speaking people. We can all be proud of this fantastic work\u00a0\u2014\u00a0and it&#8217;s not done.<\/p>\n<p>Of course, perfection is not a part of\u00a0this world and the MDN community was aware that, even if the documentation was great for skilled developers, it was not helpful for beginners or people who\u00a0knew very little\u00a0about the web: the amount of technologies is overwhelming, the absence of learning pathways is disrupting, the lack of simple, straightforward hackable examples make things hard to understand, etc. All of this makes MDN a wild and unfriendly place for beginners.<\/p>\n<p>But because we are Mozilla, we couldn&#8217;t let that stand.<\/p>\n<p>So we decided to change things and start what we call <a title=\"The project status on WikiMo\" href=\"https:\/\/wiki.mozilla.org\/MDN\/Learning_Area\">the Learning Area project<\/a>. This project try to reach the following goals:<\/p>\n<ul>\n<li>Help beginners find their way through MDN.<\/li>\n<li>Update our existing content for beginners. (Yes, we have some!)<\/li>\n<li>Fill\u00a0in\u00a0the gaps and create more beginners oriented content.<\/li>\n<li>Improve the discoverability and usability of our exiting content for beginners.<\/li>\n<li>Help beginners find good third party ressources to learn from.<\/li>\n<\/ul>\n<p>We spent the first quarter of 2014 <a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/tag\/Beginner\">analyzing content<\/a>, getting <a title=\"MDN 2014 Survey\" href=\"https:\/\/wiki.mozilla.org\/File:Learnin-area-survey-2014.pdf\">feedback from the MDN community<\/a> and <a href=\"https:\/\/etherpad.mozilla.org\/learning-area-structure\">design a plan<\/a> to change things. We also spent more time discussing with the <a href=\"https:\/\/webmaker.org\/\">WebMaker<\/a> team which makes an awesome job at teaching the web.<\/p>\n<p>And here we are, time to start writing and make MDN awesome\u00a0\u2014\u00a0again \ud83d\ude42<\/p>\n<p>So, what will happen in the next month?<\/p>\n<p>The first thing we are focusing on is to build <a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/Glossary\">a glossary of terms<\/a> to make all the web lingo clearer. At the same time, we are starting to tag MDN contents using <a href=\"https:\/\/webmaker.org\/literacy\">the Web Literacy Map<\/a> to help users find what they need easily. This is a long ongoing effort\u00a0and you are more than welcome to help. Soon after, we want to add &#8220;knowledge boxes&#8221; on MDN articles. The purpose of those boxes is to clarify what is required or simply recommended to know in order\u00a0to understand a given article. We are currently shaping this up and <a href=\"https:\/\/groups.google.com\/d\/msg\/mozilla.dev.mdc\/tFhkarS3Trc\/cZv4YQfdF40J\">we would love to hear any ideas you might\u00a0have<\/a> about it.<\/p>\n<p>By summer, the MDN team and the WebMaker team (both paid staff and volunteers) plan to meet in order to define the best way to work all together. One of the main topics will be about building self-teaching content on MDN and\/or WebMaker. Another one will be the best way to curate and promote third-party learning resources. We don&#8217;t want to reinvent the wheel, and there are so many good resources to learn the web that we want to find a way to better aggregate and promote them. On the other hand, the web is ever-changing and sometimes resources move or disappear, so links have to be maintained.<\/p>\n<p>In parallel, we are discussing the opportunity to improve our system for showing examples. Especially, we wish to make them hackable. There are plenty of technical solution to achieve this and everybody has their pet tool to do this. So stay tuned as we are planning to run a large survey to get users feedback in the next weeks.<\/p>\n<p>Finally by the end of the year, we expect to completely rebuild our learning zone on MDN, which is severely outdated. But beyond the content, we want to add a new contribution dynamic on MDN, with more focus on basics knowledge for beginners.<\/p>\n<p>Sounds good to you? Wants to get involved? Come <a href=\"https:\/\/developer.mozilla.org\/en-US\/docs\/MDN\/Community\">join the MDN community<\/a> and help us make the web better, even for beginners.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Since the beginning of the year, the MDN community has been\u00a0working on a very exciting project: building a learning area to make MDN friendly for beginners. As you probably\u00a0know, MDN &hellip; <a class=\"go\" href=\"https:\/\/blog.mozilla.org\/community\/2014\/05\/05\/let-s-make-mdn-beginners-friendly\/\">Read more<\/a><\/p>\n","protected":false},"author":719,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4364],"tags":[],"coauthors":[],"_links":{"self":[{"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/posts\/1698"}],"collection":[{"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/users\/719"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/comments?post=1698"}],"version-history":[{"count":0,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/posts\/1698\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/media?parent=1698"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/categories?post=1698"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/tags?post=1698"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blog.mozilla.org\/community\/wp-json\/wp\/v2\/coauthors?post=1698"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}