{"id":637,"date":"2017-06-06T12:59:28","date_gmt":"2017-06-06T19:59:28","guid":{"rendered":"https:\/\/blog.mozilla.org\/opendesign\/?p=637"},"modified":"2017-06-07T02:34:40","modified_gmt":"2017-06-07T09:34:40","slug":"future-mdn-focus-web-docs","status":"publish","type":"post","link":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/","title":{"rendered":"The Future of MDN: A Focus on Web Docs"},"content":{"rendered":"

Building MDN into a world class repository of high quality Web documentation is one of the most valuable things Mozilla has done for Web developers. Now we\u2019re looking to double-down on that work, and solidify MDN as the single best resource for Web docs. To support that effort, we\u2019re starting some updates to the MDN brand and website. In this post I\u2019m going to lay out what to expect, and why we think it\u2019s so important.<\/p>\n

<\/h2>\n

MDN\u2019s mission today is to provide developers with the information they need to build things on the open Web. However, when MDN was first started<\/a>, it didn\u2019t differentiate between Web standards documentation and product documentation for Firefox, Gecko and other Mozilla products. Over time, as Web documentation was expanded on MDN, it became clear that it provided value to a much larger group of developers than our internal product documentation. We have been investing to improve the Web documentation ever since.<\/p>\n

Changing the Name<\/h3>\n

MDN is clearly a web documentation reference, and in no way is it a developer network. We want the name to clearly reflect the purpose and mission of MDN, and so we\u2019re going to be updating it to: MDN Web Docs.<\/p>\n

\u201cMozilla Developer Network\u201d simply isn\u2019t accurate. Furthermore, pretty much no one refers to MDN as \u201cMozilla Developer Network.\u201d It\u2019s always \u201cMDN.\u201d However, there is a lot of love for the name \u201cMDN\u201d and we don\u2019t want to get rid of all of that, which is why we\u2019re giving it the IBM<\/a> \/ KFC<\/a> treatment and keeping the iconic abbreviation and commonly used name, while no longer using the words that the acronym used to stand for. We\u2019re not getting rid of MDN, we\u2019re being clear about what it is – it\u2019s MDN Web Docs.<\/p>\n

We\u2019re already working on what the MDN Web Docs logo will look like when rendered in the system of the new Mozilla brand, and here\u2019s an early look:<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Separating Product Documentation<\/h3>\n

Currently the home page of MDN has links to both web documentation and product documentation (like Firefox, Developer Tools, Add-ons and more), but about 95% of traffic goes to the Web documentation. Additionally, many searches can be confusing because a Web developer looking for something about CSS may end up on a page about XUL, for example CSS Grid vs XUL Grid<\/a>, and ultimately can\u2019t find the thing they were looking for. We will be splitting out the navigation for the product documentation so that MDN can be fully dedicated to helping people find the Web docs they need. We will also be investigating ways to ensure that search results direct users to exactly what they were looking for without confusing Web and product documentation.<\/p>\n

Site Design Refresh<\/h3>\n

Along with a brand identity refresh, we\u2019ll also be refreshing the site design. You will be able to see as pieces of this get completed, and you can also give feedback as we work over the coming weeks by becoming a beta tester<\/a> on MDN. We\u2019ll also follow up with future articles once there is some work to share about the new look of the site.<\/p>\n

More Content and Features To Help Web Devs<\/h3>\n

Lastly, but most importantly, we will be working to add more content and features to help Web developers. We\u2019ve already started a couple of experiments like putting examples at the top of the article, and looking at including editable code snippets within the articles. Research has told us that our documentation is excellent and thorough, but often Web developers are looking for quick examples before having to read through extensive articles. Doing more to help developers find faster and more efficient ways to learn from the documentation is a critical area where we hope to improve, and you can expect to see more experiments like this. If you have other ideas about ways that our documentation could be more valuable or easier to use, we\u2019re open to hearing more ideas<\/a>!
\nWe\u2019re incredibly excited to make MDN officially about Web docs, and to make it more comprehensive and easier to use and learn from for all of the web developers who have come to love it as a resource.<\/p>\n","protected":false},"excerpt":{"rendered":"

Building MDN into a world class repository of high quality Web documentation is one of the most valuable things Mozilla has done for Web developers. Now we\u2019re looking to double-down … Read more<\/a><\/p>\n","protected":false},"author":179,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"coauthors":[],"yoast_head":"\nThe Future of MDN: A Focus on Web Docs - Mozilla Open Design<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Kadir Topal\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/\",\"url\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/\",\"name\":\"The Future of MDN: A Focus on Web Docs - Mozilla Open Design\",\"isPartOf\":{\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage\"},\"thumbnailUrl\":\"http:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo-300x77.png\",\"datePublished\":\"2017-06-06T19:59:28+00:00\",\"dateModified\":\"2017-06-07T09:34:40+00:00\",\"author\":{\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/#\/schema\/person\/477960be85ebafbb04ed44d573db2f3a\"},\"breadcrumb\":{\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage\",\"url\":\"https:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo.png\",\"contentUrl\":\"https:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo.png\",\"width\":2523,\"height\":646},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.mozilla.org\/opendesign\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Future of MDN: A Focus on Web Docs\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/#website\",\"url\":\"https:\/\/blog.mozilla.org\/opendesign\/\",\"name\":\"Mozilla Open Design\",\"description\":\"branding without walls\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.mozilla.org\/opendesign\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.mozilla.org\/opendesign\/#\/schema\/person\/477960be85ebafbb04ed44d573db2f3a\",\"name\":\"Kadir Topal\",\"description\":\"Kadir Topal is the Product Lead for MDN Web Docs where he works with his team to provide developers with the information they need to build delightful experiences on the open web. He also works with a group of browser vendors and the W3C on the annual Web Developer Needs Assessment. He\u2019s been a long term contributor to Mozilla, having started the German Firefox community in 2002. Kadir lives in the Ruhr area in Germany.\",\"url\":\"https:\/\/blog.mozilla.org\/opendesign\/author\/atopalmozilla-com\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"The Future of MDN: A Focus on Web Docs - Mozilla Open Design","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/","twitter_misc":{"Written by":"Kadir Topal","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/","url":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/","name":"The Future of MDN: A Focus on Web Docs - Mozilla Open Design","isPartOf":{"@id":"https:\/\/blog.mozilla.org\/opendesign\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage"},"image":{"@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage"},"thumbnailUrl":"http:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo-300x77.png","datePublished":"2017-06-06T19:59:28+00:00","dateModified":"2017-06-07T09:34:40+00:00","author":{"@id":"https:\/\/blog.mozilla.org\/opendesign\/#\/schema\/person\/477960be85ebafbb04ed44d573db2f3a"},"breadcrumb":{"@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#primaryimage","url":"https:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo.png","contentUrl":"https:\/\/blog.mozilla.org\/opendesign\/files\/2017\/06\/logo.png","width":2523,"height":646},{"@type":"BreadcrumbList","@id":"https:\/\/blog.mozilla.org\/opendesign\/future-mdn-focus-web-docs\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.mozilla.org\/opendesign\/"},{"@type":"ListItem","position":2,"name":"The Future of MDN: A Focus on Web Docs"}]},{"@type":"WebSite","@id":"https:\/\/blog.mozilla.org\/opendesign\/#website","url":"https:\/\/blog.mozilla.org\/opendesign\/","name":"Mozilla Open Design","description":"branding without walls","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.mozilla.org\/opendesign\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.mozilla.org\/opendesign\/#\/schema\/person\/477960be85ebafbb04ed44d573db2f3a","name":"Kadir Topal","description":"Kadir Topal is the Product Lead for MDN Web Docs where he works with his team to provide developers with the information they need to build delightful experiences on the open web. He also works with a group of browser vendors and the W3C on the annual Web Developer Needs Assessment. He\u2019s been a long term contributor to Mozilla, having started the German Firefox community in 2002. Kadir lives in the Ruhr area in Germany.","url":"https:\/\/blog.mozilla.org\/opendesign\/author\/atopalmozilla-com\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/posts\/637"}],"collection":[{"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/users\/179"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/comments?post=637"}],"version-history":[{"count":0,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/posts\/637\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/media?parent=637"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/categories?post=637"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/tags?post=637"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blog.mozilla.org\/opendesign\/wp-json\/wp\/v2\/coauthors?post=637"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}