Update documentation

Author: microbit-matt-hillsdon

README.md

@@ -1,8 +1,10 @@
 # micro:bit MicroPython stubs for editor support
 
+The easiest way to try these type stubs is to use the online [micro:bit Python Editor](https://python.microbit.org) which bundles them.
+
 ## Translations
 
-We maintain translations of these files via Crowdin.
+We maintain translations of these files in the [micro:bit Crowdin project](https://crowdin.com/project/microbitorg) in [this file](https://crowdin.com/translate/microbitorg/6422). Only changes to the English source should be made in this repository.
 
 The source content is in English in `lang/en`.
 
@@ -12,12 +14,12 @@ We translate:
 
 - First lines of all docstrings
 - First lines of parameter documentation in `:param name:`-style
-- The API name, e.g. function name, with underscores replaced with spaces to make clear it's a hint not the actual name
-- Parameter names (again with underscores replaced)
+- The API name, e.g. function name, with underscores replaced with spaces to make clear it's a hint not the actual name. This is displayed alongside the English API name.
+- Parameter names (again with underscores replaced). These are displayed alongside the English parameter name.
 
 ## Credit and licensing
 
-builtins and utility definitions are derived from [typeshed](https://github.com/python/typeshed). Further work is required to review these to ensure that we don't have stubs for definitions MicroPython does not support. These stubs don't provide documentation.
+builtins and utility definitions are derived from [typeshed](https://github.com/python/typeshed). These stubs don't provide documentation, though we'd love to add it in future.
 
 MicroPython and micro:bit stubs are based on the restructured text documentation for [micro:bit](https://github.com/bbcmicrobit/micropython/tree/v2-docs) and, where not otherwise covered in micro:bit-specific docs, [MicroPython](https://github.com/micropython/micropython/tree/master/docs/library). These stubs provide documentation.