ARMmbed · iriark01 · May 11, 2020 · Apr 22, 2020 · Apr 22, 2020 · Apr 22, 2020
diff --git a/...rogram-setup/bare_metal/bare_metal_api.md → deprecated/bare_metal_api.md b/...rogram-setup/bare_metal/bare_metal_api.md → deprecated/bare_metal_api.md
@@ -1,5 +1,33 @@
 # Bare metal APIs
 
+The bare metal profile starts with a restricted list of API, to which you can add what you need. However, bare metal doesn't support all Mbed OS APIs.
+
+## Initial list of APIs
+
+By default, bare metal includes the following APIs:
+
+## Adding APIs
+
+<!--how?-->
+
+## Full list of APIs
+
+The [Mbed OS API list]() indicates which APIs are supported by bare metal.
+
+<!--
+Evelyne, my suggestion is to use something like
+
+
+| API | Full Mbed OS | Bare metal |
+| - | - | - |
+| AnalogIn | &#9745; | &#9745; |
+
+Although it's a bit silly, because of course it's supported in the full Mbed OS... I'd love some suggestions
+-->
+
+<!--
+# Bare metal APIs
+
 Mbed OS bare metal supports the following APIs:
 
 <h2 id="analog-i-o">Analog I/O</h2>
@@ -45,3 +73,5 @@ Mbed OS bare metal supports the following APIs:
 - I2CSlave - I²C bus slave.
 
 - CAN - Controller-area network bus.
+
+-->
diff --git a/docs/api/io/io_intro.md → deprecated/io_intro.md b/docs/api/io/io_intro.md → deprecated/io_intro.md
diff --git a/docs.json b/docs.json