Documentation improvements

docs/README.md

@@ -0,0 +1,37 @@
+# Documentation
+
+ **★ WORK IN PROGRESS ★**
+
+
+## Compiler usage
+
+* [Getting started](api/getting-started.md)
+
+* [Command-line option reference](api/command-line.md)
+
+* [Target platform reference](api/target-platforms.md)
+
+## Language reference
+
+* [Syntax](lang/syntax.md)
+
+* [Types](lang/types.md)
+
+* [Operators reference](lang/operators.md)
+
+* [Functions](lang/functions.md)
+
+* [Inline assembly syntax](lang/assembly.md)
+
+* [Important guidelines regarding reentrancy](lang/reentrancy.md)
+
+
+## Implementation details
+
+* [Variable storage](abi/variable-storage.md)
+
+* [Undefined behaviour](abi/undefined-behaviour.md)
+
+* [Undocumented instruction support](abi/undocumented.md)
+
+* [Reference for labels in generated assembly code](abi/generated-labels.md)