From 58ce5d9bf24ce482c5d25d9f7d110861f420ee7b Mon Sep 17 00:00:00 2001
From: Ayke van Laethem <aykevanlaethem@gmail.com>
Date: Sun, 21 Oct 2018 20:22:21 +0200
Subject: [PATCH] docs: add WebAssembly to targets and improve formatting

---
 docs/targets.rst | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/docs/targets.rst b/docs/targets.rst
index 45985e14..3c8b300e 100644
--- a/docs/targets.rst
+++ b/docs/targets.rst
@@ -7,12 +7,25 @@
 Supported targets
 =================
 
-The following boards are currently supported:
+TinyGo makes it easy to add new targets. If your target isn't listed here,
+please raise an issue in the `issue tracker
+<https://github.com/aykevl/tinygo/issues>`_.
+
+
+POSIX-like
+----------
+
+Only Linux is supported at the moment, but it should be trivial to add support
+for more POSIX-like systems.
+
+
+ARM / Cortex-M
+--------------
+
+Cortex-M processors are well supported. There is support for multiple chips and
+the backend appears to be stable. In fact, it uses the same underlying
+technology (LLVM) as the proprietary ARM compiler for code generation.
 
-  * `Arduino Uno <https://store.arduino.cc/arduino-uno-rev3>`_ (`ATmega328p
-    <https://www.microchip.com/wwwproducts/en/ATmega328p>`_) |br|
-    Note: the AVR backend of LLVM is still experimental so you may encounter
-    bugs.
   * `BBC micro:bit <https://microbit.org/>`_ (`nRF51822
     <https://www.nordicsemi.com/eng/Products/Bluetooth-low-energy/nRF51822>`_)
   * `Nordic PCA10040
@@ -27,6 +40,21 @@ The following boards are currently supported:
     on real hardware.
 
 
+AVR
+---
+
+Note: the AVR backend of LLVM is still experimental so you may encounter bugs.
+
+  * `Arduino Uno <https://store.arduino.cc/arduino-uno-rev3>`_ (`ATmega328p
+    <https://www.microchip.com/wwwproducts/en/ATmega328p>`_)
+
+
+WebAssembly
+-----------
+
+WebAssembly support is relatively new but appears to be stable.
+
+
 .. note::
    Support for the ESP8266/ESP32 chips will take a lot of work if they ever get
    support. See :ref:`this FAQ entry <faq-esp>` for details.