From aca863f436fea23c1dea945e07d8471225d8f514 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <jhalleux@microsoft.com>
Date: Wed, 17 Aug 2016 08:39:50 -0700
Subject: [PATCH] adding translation docs

---
 docs/docs.md      |  1 +
 docs/faq.md       |  4 ++++
 docs/translate.md | 28 ++++++++++++++++++++++++++++
 3 files changed, 33 insertions(+)
 create mode 100644 docs/translate.md

diff --git a/docs/docs.md b/docs/docs.md
index 177e231a..c3315da2 100644
--- a/docs/docs.md
+++ b/docs/docs.md
@@ -19,6 +19,7 @@
 ### More questions?
 
 * [Frequently Asked Question](/faq)
+* [Help Translate](/translate)
 * [Release notes](/release-notes)
 
 ### Developers
diff --git a/docs/faq.md b/docs/faq.md
index c94403a2..d8b7aa0d 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -20,6 +20,10 @@ To share your project with others, you can use the **Embed** feature. It stores
 
 If you are using [Visual Studio Code](/code), all your programs are stored as files on your computer and you can use your favorite source control system as needed.
 
+## Is the web site available in other languages?
+
+You can [help us translate](/translate) the web site, documentation and blocks via our crowd-source translations! 
+
 ## Troubleshooting
 
 ### My micro:bit does not show up as a drive when I connect it to my computer.
diff --git a/docs/translate.md b/docs/translate.md
new file mode 100644
index 00000000..053e3155
--- /dev/null
+++ b/docs/translate.md
@@ -0,0 +1,28 @@
+# Help translate
+
+Our translations are managed via Crowdin, a translation management platform. It is free to join
+and you can volunteer to translate parts of the web site.
+
+## Translating the editor interface
+
+The project below contains the resources from https://www.pxt.io and the menu items of https://codethemicrobit.com.
+
+* [https://crowdin.com/project/kindscript](https://crowdin.com/project/kindscript)
+
+You will find two files in that project:
+
+* ``string.json``: text contained in the menu items of https://codethemicrobit.com
+* ``website.json``: text contained in the pages served by https://www.pxt.io 
+
+## Translating the blocks and reference documentation
+
+The project below contains the resources from the blocks and functions using in the https://codethemicrobit.com.
+
+* [https://crowdin.com/project/pxt-microbit](https://crowdin.com/project/pxt-microbit)
+
+You will find two files for each package available in the micro:bit, one for the block definition and one for the descriptions:
+
+* ``microbit-strings.json``: contains the block definitions
+* ``microbit-jsdoc-strings.json``: contains the descriptions
+
+The block definition should be carefully translated using the [block definition syntax](https://www.pxt.io/defining-blocks).
\ No newline at end of file