Created first draft of client library page.

ralph-lange · ralph-lange · commit 2d53c08c75f0 · 2019-05-24T10:39:16.000+02:00
Signed-off-by: Ralph Lange (CR/AEE1) &lt;ralph.lange@de.bosch.com&gt;
diff --git a/_data/docs.yml b/_data/docs.yml
@@ -20,7 +20,8 @@
 - title: Concepts
   docs:
    - rtos
+   - client_library
    - real-time_executor
-   - embedded_tf
    - system_modes
+   - embedded_tf
    - FIROS2
diff --git a/_docs/client_library/index.md b/_docs/client_library/index.md
@@ -0,0 +1,18 @@
+---
+title: Client Library
+permalink: /docs/client_library/
+---
+
+## Overview
+
+The client library provides the micro-ROS API for the user code, i.e. for application-level micro-ROS nodes. The overall goal is to provide all relevant, major ROS 2 concepts in suitable implementation for microcontrollers. Where possible, API compatibility with ROS 2 shall be achieved for ease of portability.
+
+In this undertaking, to minimize the long-term maintenance cost, we strive to use existing data structures and algorithms from the ROS 2 stack or to bring necessary changes in the mainline stack. In detail, this raises a lot of question regarding the applicability of existing ROS 2 layers on microcontrollers in terms of runtime efficiency, portability to different RTOS, dynamic memory management, and many more. These are explored and analyzed in a dedicated [decision paper](decision_paper/).
+
+## Advanced Concepts
+
+Advanced concepts developed in the context of the client library are documented separately. These are:
+
+* [Real-Time Executor](/docs/real-time_executor/)
+* [System Modes](/docs/system_modes/)
+* [Embedded Transform (TF)](/docs/embedded_tf/)
