better api

Author: alelavml3

md-docs/api/examples.md

@@ -1,4 +1,4 @@
-We wrote for you a set of notebooks that can help you to understand how to use ML cube Platform SDK:
+We prepared for you a set of notebooks that can help you to understand how to use ML cube Platform SDK:
 
 - [0 - Company and Project]
 - [1 - Task and Model]

md-docs/api/index.md

@@ -1,11 +1,23 @@
-# Client SDK
+# ML cube Platform API
 
+ML cube Platform is an API-first application that provides full coverage of its functionalities both as Web Application and as API.
+In particular, we provide a Python SDK facilitating the interaction using high-level objects and automated procedures.
 
-ML cube Platform allows interaction through REST APIs:
+<div class="grid cards" markdown>
 
-- :fontawesome-brands-python: __[Python]__ – Install Python Client on your environment
-- :material-api: __[REST]__ – Use directly the API
-- :simple-jupyter: __[EXAMPLES]__ - Jupyer Notebook examples
-  [Python]: python/index.md
-  [REST]: rest/index.md
-  [EXAMPLES]: examples.md
+-   :fontawesome-brands-python:{ .lg .middle } **Python SDK**
+
+    ---
+
+    Documentation page of Python SDK with low level details of available methods.
+
+    [:octicons-arrow-right-24: More info](python/index.md)
+
+-   :simple-jupyter:{ .lg .middle } **Notebook Examples**
+
+    ---
+
+    Jupyter notebooks examples showing most of the basic usage of ML cube Platform.
+
+    [:octicons-arrow-right-24: More info](examples.md)
+</div>

md-docs/api/python/index.md

@@ -1,9 +1,19 @@
 # ML3 platform client SDK
 
+ML cube Platform SDK is a Python client that helps you interacting with ML cube Platform using high-level objects.
+The available sections are:
+
+- [Client:](client.md)
+    the Client is the main class to use the SDK, it is initialized with the application url (https://api.platform.mlcube.com) and with the user API Key.
+    It exposes all the methods to use ML cube Platform programmatically.
+- [Models:](models.md)
+    Pydantic models used as support objects in the SDK.
+- [Enums:](enums.md)
+    Enumerations available in the SDK.
+- [Exceptions:](exceptions.md)
+    Exceptions raised by the Client.
+
 ## Installation
 ```bash
 pip install ml3-platform-sdk
 ```
-
-## Usage
-Please refer to the [documentation](https://ml-cube.github.io/ml3-platform-docs/)

md-docs/index.md

@@ -60,7 +60,7 @@ Dive in to explore everything ML cube Platform has to offer, and feel free to re
 
     [:octicons-arrow-right-24: More info](api/index.md)
 
--   :material-notebook:{ .lg .middle } **Notebook Examples**
+-  :simple-jupyter:{ .lg .middle } **Notebook Examples**
 
     ---