Contributing to the translated content of MDN Web Docs
:tada: First of all, thanks for taking the time to contribute to MDN Web Docs’ translated content! :tada:
Before we go any further, you should be aware that we are only accepting updates to active locales — this means locales that have active community maintenance teams in place to review PRs, fix issues, make updates, etc. Currently the list of active locales is:
Code of Conduct
Everyone participating in this project is expected to follow our Code of Conduct.
When contributing to the content you agree to license your contributions according to our license.
A good place to learn about general guidelines for contributing to MDN Web Docs is the Guidelines document. For example, you can find out more about MDN's writing-style guidelines via the Writing style guide.
Setting up to edit
This repo has exactly the same folder structure, concepts, and commands available to it as the content repo, which holds all of MDN's English content. The main difference is in the setup you need to do before you can start editing. It is mostly the same, but there is a little bit more to consider.
To begin with, get the basic required tooling set up, as described in the content repo Setup section.
Now you need to fork and clone both the content repo and the translated-content repo (this repo).
Content repo setup
Once the above is done, cd into the content repo.
Run the command
yarn installto fetch the latest packages and get the local MDN testing environment set up. It is also recommended that you run
yarn installbefore every update you do to the source, to make sure you have the latest packages.
Next, create an environment variable called
CONTENT_TRANSLATED_ROOTcontaining the path to the translated-content repo’s
filesdirectory. You could do this for a single session like so:
But you’ll have to newly-set this every time you open up a new terminal window. Instead, you could put the environment variable setting in an
.envfile in the root of your content repo. This is most easily done using the following command:
echo CONTENT_TRANSLATED_ROOT=/path/to/translated-content/files >> .env
.envfile will be created for you if it does not already exist.)
Now you’ve got this set up, enter the command
yarn startto begin the local testing server running at
Working in the translated-content repo
Over in the translated-content repo, decide what change you want to make, and then:
Create a new branch to make your changes in.
Switch to your new branch and make the changes you want to make. You can keep going back to
localhost:5042/frfor French) to test your changes and make sure the content looks how you want it to look.
When you are satisfied with your changes, create a pull request and one of our review teams will review it.
Once the pull request has been merged, the edition may take up to 48 hours (daily build and CDN caches). To see if your change has been deployed, you can check on What's Deployed.
For more info on editing this repo
For more information, we’d like to suggest that you go to the content repo and read its README file, particularly to learn about fundamental concepts, pull request etiquette, and common actions such as adding, moving, or deleting documents.