MDN Web Docs Gets Revamp
Written by Alex Denham   
Thursday, 03 November 2022

MDN Web Docs is being revamped to reorganize the Contribution Docs, the pages that explain what MDN is all about and how to work within it.

MDN is a key resource not only for web developers but for almost everyone who writes code. It is a free-to-use resource that documents the open web platform and provides developers with the information they need to easily build projects on the web platform.


MDN Web Docs was originally created by Mozilla, and is now managed and maintained by Open Web Docs. The site has been undergoing a major modernization with the aim of creating a clean and inviting website that makes navigating the site's 44,000 articles as easy as possible. The developers wanted to create a more holistic experience for our users, with an emphasis on improved navigability and a universal look and feel across all the pages.

The MDN team says the Contributions Docs

"describe what’s what – the templates and page structures, how to perform a task on MDN, how to contribute to MDN, and the community guidelines to follow while contributing to this massive open source project". 

The revamp began with a grouping and reorganization of the content into two distinct buckets – Community guidelines and Writing guidelines. All the information about open source etiquette, discussions, process flows, users and teams, and how to get in touch with the maintainers in the Community guidelines section, while the information about how to write for MDN, what the contributors write, what is regarded as experimental, and so on is now in the Writing guidelines section.

The team has also restructured some documents, such as the Writing style guide, and has reviewed and removed outdated as well as repeated content.  This included moving some repository-specific information to the respective repository. For example, a better home for the content about “Matching web features to browser release version numbers” is in the mdn/browser-compat-data repository.

The updated version is live now. 


More Information

MDN Web Docs

Related Articles

MDN Plus - A Premium Service

MDN Web Docs Has New Platform and New Funding

MDN Web Docs Call For Participation

Mozilla's Plan For Easier Web Development

Mozilla Layoffs Include MDN Team

MDN Is 15 - How Did It Reach Top Of The Docs?


To be informed about new articles on I Programmer, sign up for our weekly newsletter, subscribe to the RSS feed and follow us on Twitter, Facebook or Linkedin.


Mockito 5.0.0 Released

The venerable Java testing framework which allows the creation of test double objects in automated unit tests for the purpose of test-driven or behavior-driven development is going through a [ ... ]

GitLab Announces Remote Development Feature

GitLab, the web-based repository manager for Git, has anounced betas of two development features, Remote Development and Value Streams Dashboard.

More News





or email your comment to: