From 34b3b534b5b60eb9f25ab8d7e2890763e50c82af Mon Sep 17 00:00:00 2001
From: KoalaSat <koalasat@satstralia.com>
Date: Fri, 27 Jun 2025 15:05:39 +0000
Subject: [PATCH] Update docs.md

---
 development/docs.md | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/development/docs.md b/development/docs.md
index 7d8b3af5..d046a01b 100644
--- a/development/docs.md
+++ b/development/docs.md
@@ -1 +1,19 @@
-# Documentation
\ No newline at end of file
+# Documentation
+
+## Client
+
+### Garage
+
+The `Garage` contains user's tokens separated by `Slots` . Every `Slot` has the core data generated with the token and a set of `Robots`. Each `Robot` contains the information a `Coordinator` returns about that specific token. Tokens should be always sent to all coordinators on creation/recovery to ensure consistency and good UX. 
+
+<div align="center">
+  <img src="/development/assets/garage.png" width="500px">
+</div>
+
+### Federation
+
+The `Federation` stores all available coordinators. A `Coordinator` has the main data obtained from its API: `/api/book`, `/api/limits` and `/api/info`. This information from coordinators is aggregated in the `Federation`: `book` for all orders and `exchange` for coordinator's meta data. 
+
+<div align="center">
+  <img src="/development/assets/federation.png" width="500px">
+</div>