| | --- |
| | language: |
| | - ar |
| | - en |
| | tags: |
| | - content |
| | license: mit |
| | --- |
| | |
| | # Welcome to MDN Web Docs |
| |
|
| |  |
| |
|
| | [MDN Web Docs][] is an open-source, collaborative project that documents web technologies including CSS, HTML, JavaScript, and Web APIs. |
| | Alongside detailed reference documentation, we provide extensive learning resources for students and beginners getting started with web development. |
| |
|
| | ## MDN's mission |
| |
|
| | MDN's mission is to provide a blueprint for a better internet and empower a new generation of developers and content creators to build it. |
| |
|
| | The strength of MDN Web Docs lies in its vast community of active readers and contributors. |
| | Since 2005, approximately 45,000 contributors have created the documentation we know and love. |
| | Together, contributors have created over 45,000 documents that make up an up-to-date, comprehensive, and free resource for web developers worldwide. |
| |
|
| | In addition to English-language articles, over 35 volunteers lead translation and localization efforts for Chinese, French, Japanese, Korean, Portuguese, Russian, and Spanish. |
| |
|
| | ## Build the site |
| |
|
| | To set up the site locally, you need to have [Node.js](https://nodejs.org/) installed, which comes bundled with [npm](https://www.npmjs.com/). |
| | You can check if these are installed by running the following commands: |
| |
|
| | ```bash |
| | node -v |
| | npm -v |
| | ``` |
| |
|
| | After you have installed Node.js, you can install the dependencies using `npm install` and start the local preview: |
| |
|
| | ```bash |
| | npm i |
| | npm start |
| | ``` |
| |
|
| | Once started, a live preview is available at `http://localhost:5042/`. |
| |
|
| | ## Contribute to MDN Web Docs |
| |
|
| | You can contribute to MDN Web Docs and be a part of our community through content contributions, engineering, or translation work. |
| | The MDN Web Docs project welcomes contributions from everyone who shares our goals and wants to contribute constructively and respectfully within our community. |
| |
|
| | To find out how to get started, see the [CONTRIBUTING.md](CONTRIBUTING.md) document in this repository. |
| | By participating in and contributing to our projects and discussions, you acknowledge that you have read and agree to our [Code of Conduct](CODE_OF_CONDUCT.md), which means adhering to [Mozilla's Community Participation Guidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/). |
| |
|
| | ## Get in touch |
| |
|
| | You can communicate with the MDN Web Docs team and community using the [communication channels][]. |
| |
|
| | <!--- |
| | Reference links syntax is used here because of linting markdown files ("fqdn-moz-links" rule). |
| | See https://github.com/mdn/content/pull/21432 and https://github.com/mdn/content/pull/38369. |
| | It can be replaced with the normal links syntax after successfully closing https://github.com/DavidAnson/markdownlint/issues/673. |
| | --> |
| |
|
| | [mdn web docs]: https://developer.mozilla.org |
| | [communication channels]: https://developer.mozilla.org/en-US/docs/MDN/Community/Communication_channels |
| |
|
