up

Author: iliakan

TRANSLATION.md

@@ -1,13 +1,79 @@
+# Translation Style Guide
 
-# The JavaScript Tutorial
+This document describes rules that should be applied to **all** languages.
 
-This repository hosts the translation of the [Modern JavaScript Tutorial](https://javascript.info).
+NOTE TO MAINTAINERS: You may want to translate this guide so that it can be more accessible to your translators.
 
-The full list of translations and leads is at <https://github.com/iliakan/javascript-tutorial-en>.
+## General
 
-Please contact the translation lead for any questions. 
-Contact @iliakan there's no answer or the translation appears to be stalled. 
+The translation doesn't have to be word-by-word precise.
 
-If there are other translators, notify them (create an issue?) when you're taking a chapter.
+It should be technically correct and explain well.
 
+If you feel the original text could be improved, please send a PR.
 
+## Text in Code Blocks
+
+- Translate comments in code blocks.
+- Translate example strings (optionally).
+- Don't translate variable names, ids, classes.
+
+Example:
+
+```js
+// Example
+const text = "Hello, world";
+document.querySelector('.hello').innerHTML = text;
+```
+
+✅ DO (translate comment):
+
+```js
+// Ejemplo
+const text = 'Hello, world';
+document.querySelector('.hello').innerHTML = text;
+```
+
+✅ ALSO OKAY (also text):
+
+```js
+// Ejemplo
+const text = 'Hola mundo';
+document.querySelector('.hello').innerHTML = text;
+```
+
+❌ DON'T (translate class):
+
+```js
+// Ejemplo
+const text = 'Hola mundo';
+// ".hello" is a class
+// DO NOT TRANSLATE
+document.querySelector('.hola').innerHTML = text;
+```
+
+❌ DEFINITELY DON'T (translate variables):
+
+```js
+// Ejemplo
+const texto = 'Hola mundo';
+documento.querySelector('.hola').interiorHTML = texto;
+```
+
+## External Links
+
+If an external link is to Wikipedia, e.g. <https://en.wikipedia.org/wiki/JavaScript>, and a version of that article exists in your language that is of decent quality, consider linking to that version instead.
+
+Example:
+
+```md
+[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
+```
+
+✅ OK:
+
+```md
+[JavaScript](https://es.wikipedia.org/wiki/JavaScript) es un lenguaje de programación.
+```
+
+For links that have no equivalent, just use the English link.