radicalbit · maocorte · Aug 5, 2024 · Aug 5, 2024 · Aug 5, 2024 · Aug 5, 2024
diff --git a/docs/docs/l6_all_metrics.md → docs/docs/all-metrics.md b/docs/docs/l6_all_metrics.md → docs/docs/all-metrics.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 5
 ---
 
 # All metrics

diff --git a/docs/docs/architecture.md b/docs/docs/architecture.md
@@ -0,0 +1,27 @@
+---
+sidebar_position: 6
+---
+
+# Architecture
+
+In this section we explore the architecture of the Radicalbit AI platform.
+The image below shows all the components of the platform:
+
+![Alt text](/img/architecture/architecture.png "Architecture")
+
+## API
+
+API is the core of the platform, it exposes all the functionalities via REST APIs.
+It requires a PostgreSQL database to store data and a Kubernetes cluster to run Spark jobs for metrics evaluations.
+To store all dataset files a distributed storage is used.
+REST APIs could be used via user interface or using the provided Python SDK.
+
+## UI
+
+To use REST APIs with a human friendly interface, a UI is provided.
+It covers all the implemented APIs, starting from model creation and ending with all metrics visualization.
+
+## SDK
+
+To interact with API programmatically, a [_Python SDK_](/python-sdk) is provided.
+The SDK implements all functionalities exposed via REST API.
diff --git a/docs/docs/l3_model_sections/_category_.json → docs/docs/model-sections/_category_.json b/docs/docs/l3_model_sections/_category_.json → docs/docs/model-sections/_category_.json
@@ -1,6 +1,6 @@
 {
   "label": "Model sections",
-  "position": 1,
+  "position": 4,
   "link": {
     "type": "generated-index",
     "description": "Each created models has three main sections: Overview, Reference, and Current. In this document we are thoroughly explaining each of them."

diff --git a/docs/docs/l3_model_sections/current.md → docs/docs/model-sections/current.md b/docs/docs/l3_model_sections/current.md → docs/docs/model-sections/current.md
diff --git a/docs/docs/l3_model_sections/overview.md → docs/docs/model-sections/overview.md b/docs/docs/l3_model_sections/overview.md → docs/docs/model-sections/overview.md
diff --git a/docs/docs/l3_model_sections/reference.md → docs/docs/model-sections/reference.md b/docs/docs/l3_model_sections/reference.md → docs/docs/model-sections/reference.md
diff --git a/docs/docs/l5_python_sdk.md → docs/docs/python-sdk.md b/docs/docs/l5_python_sdk.md → docs/docs/python-sdk.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 4
 ---
 
 # Python SDK

diff --git a/docs/docs/l1_quickstart.md → docs/docs/quickstart.md b/docs/docs/l1_quickstart.md → docs/docs/quickstart.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 2
 ---
 
 # Quickstart

diff --git a/docs/docs/l7_support.md → docs/docs/support.md b/docs/docs/l7_support.md → docs/docs/support.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+sidebar_position: 7
 ---
 
 # Community Support

diff --git a/docs/docs/l2_user_guide/_category_.json → docs/docs/user-guide/_category_.json b/docs/docs/l2_user_guide/_category_.json → docs/docs/user-guide/_category_.json
@@ -1,6 +1,6 @@
 {
   "label": "User Guide",
-  "position": 1,
+  "position": 3,
   "link": {
     "type": "generated-index",
     "description": "Welcome to the «radicalbit-ai-monitoring» user guide. This document is designed to help you get started with our platform, understand its core concepts and make the most out of its features. Whether you are a new user or an experienced professional, this guide will provide you with the necessary information to effectively monitor and manage your AI systems."

diff --git a/docs/docs/l2_user_guide/how_to.md → docs/docs/user-guide/how-to.md b/docs/docs/l2_user_guide/how_to.md → docs/docs/user-guide/how-to.md
diff --git a/.../l2_user_guide/user-guide-installation.md → docs/docs/user-guide/installation.md b/.../l2_user_guide/user-guide-installation.md → docs/docs/user-guide/installation.md
diff --git a/...s/l2_user_guide/user-guide-keyconcepts.md → docs/docs/user-guide/key-concepts.md b/...s/l2_user_guide/user-guide-keyconcepts.md → docs/docs/user-guide/key-concepts.md
diff --git a/docs/static/img/architecture/architecture.png b/docs/static/img/architecture/architecture.png