translate

AUTHORING.md

@@ -0,0 +1,37 @@
+
+# Authoring
+
+This describes important stuff about authoring new articles of the tutorial.
+
+## Internal links
+
+All tutorial links should start from the root, not including the domain.
+
+✅ OK:
+
+```md
+We'll cover that in the chapter [about functions](/function-basics)
+```
+
+❌ Not ok:
+
+```md
+We'll cover that in the chapter [about functions](https://javascript.info/function-basics)
+```
+
+Also, to reference a chapter, there's a special "info:" scheme, like this:
+
+```md
+We'll cover that in the chapter <info:function-basics>.
+```
+
+Becomes:
+```html
+We'll cover that in the chapter <a href="/function-basics">Function basics</a>.
+```
+
+The title is auto-inserted from the referenced article. That has the benefit of keeping the right title if the article gets renamed.
+
+## TODO
+
+Ask @iliakan to for more details.

TRANSLATION.md

@@ -62,7 +62,7 @@ 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.
+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:
 
@@ -70,10 +70,12 @@ Example:
 [JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.
 ```
 
-✅ OK:
+✅ OK (en -> es):
 
 ```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.
+For links to MDN, that are only partially translated, also use the language-specific version.
+
+If a linked article has no translated version, leave the link "as is".