content

This is the source repository for MDN Web Docs, the reference website that web developers use to look up how HTML, CSS, JavaScript, HTTP, and browser APIs work. Every article, tutorial, and reference page on developer.mozilla.org is stored here as a Markdown file, and changes go through the normal GitHub pull request process.

MDN has been running since 2005. In that time, roughly 45,000 contributors have written and maintained more than 45,000 documents covering the full range of web technologies. The site serves both beginners learning web development for the first time and experienced developers checking the exact syntax or behavior of a specific API. Because it is open-source and community-maintained, anyone can fix a mistake or add missing information by filing an issue or submitting a pull request.

The main repository covers documentation in English. Translation into other languages is handled by a separate effort, with over 35 volunteers coordinating localized versions in Chinese, French, Japanese, Korean, Portuguese, Russian, and Spanish.

If you want to run a local preview of the docs site, you need Node.js installed. After cloning the repository and running npm install followed by npm start, a development server starts at localhost and shows a live preview that updates as you edit files.

Contributing to MDN does not require programming knowledge. Writing, editing, improving examples, and correcting technical errors are all valued contributions. The CONTRIBUTING.md file in the repository explains the process for getting started, and the project follows Mozilla's community participation guidelines for how contributors interact with each other.