Translations

Thanks for your interest in helping translating the guides!

Starting a translation

Before you start working on a translation, look through the open pull requests to see if anyone else is already working on one for your language.

If there's not, then today is your day to lead this effort! Here's how to start:

Fork this repository
Create a new branch for your translation work e.g. es.
Copy _data/locales/en.yml to your target language file e.g. _data/locales/es.yml and translate all the strings.
Copy index.html to your target language index file e.g. es.html and update the lang:.
Create a new directory in _articles/ for your language e.g. _articles/es/, copy each guide from _articles/ into that folder and translate each guide.
Run script/test and make sure there are no failures with your translation files. Note that you may need to rename anchor links or leave some headers in English to fix broken links.
Send a pull request.