Translation Guidance

General guidance


Please leave the code, HTML, and markdown as is without changing it.

Make sure to:

Most links are formatted with single or double brackets and parentheses; for example:

Just so you know:

Make sure to:

Text Editor

The markdown files are very sensitive to indentation, commas, quotes, and special characters.

We recommend that you use a markdown editor or a simple text editor (including GitHub interface) — and not a document editor like Microsoft Word that often changes quotes and indentation.


Resource-Specific Information

Some resources have specific Translations notes.

We are here to help

If you have any questions about the translation, please report them in the related GitHub issue so that WAI team and other volunteers can help. Alternatively, send an e-mail to the publicly-archived mailing-list.

We are happy to help you decide on the best translated wording by sharing the considerations and nuances that went into choosing the wording for the English page.

Back to Top