Update documentation: refine installation instructions and enhance project description

Author: iMicknl

docs/getting-started.md

@@ -7,14 +7,17 @@
 
 ## Install pyOverkiz from PyPi
 
+
+### With UV <small>recommended</small> { #with-uv data-toc-label="with uv" }
+
 ```bash
-pip install pyoverkiz
+uv add pyoverkiz
 ```
 
-If you use uv:
+### With pip
 
 ```bash
-uv add pyoverkiz
+pip install pyoverkiz
 ```
 
 ## Choose your server

docs/index.md

@@ -2,36 +2,32 @@
 hide:
   - navigation
   - toc
+  - title
 ---
 # pyOverkiz
 
-pyOverkiz is an async Python client for the OverKiz platform, used by vendors like Somfy and Atlantic. It lets you authenticate, discover devices, read states, execute commands, and consume gateway events.
+pyOverkiz is an async Python library for interacting with Overkiz-based platforms, including Somfy and Atlantic. It enables authentication, device discovery, state reading, command execution, and real-time event streaming from supported gateways.
 
 ## What you can do
 
-- Connect to cloud or local gateways
-- Discover devices and read states
-- Send commands to your devices
-- Consume event streams for near real-time updates
+- Authenticate with Overkiz cloud or local gateways
+- Automatically discover and list connected devices
+- Read device states and attributes
+- Execute commands on devices
+- Receive real-time updates via event streams
 
 ## Supported hubs
 
 - Atlantic Cozytouch
 - Bouygues Flexom
-<!-- - Brandt Smart Control **\*** -->
 - Hitachi Hi Kumo
 - Nexity Eugénie
-<!-- - Rexel Energeasy Connect **\*** -->
 - Sauter Cozytouch
 - Simu (LiveIn2)
 - Somfy Connexoon IO
 - Somfy Connexoon RTS
 - Somfy TaHoma
 - Somfy TaHoma Switch
 - Thermor Cozytouch
-
-## Where to go next
-
-- Start with the [Getting started](getting-started.md) guide
-- Learn the architecture in [Core concepts](core-concepts.md)
-- Browse the [API reference](api-reference.md)
+<!-- - Brandt Smart Control **\*** -->
+<!-- - Rexel Energeasy Connect **\*** -->

mkdocs.yml

@@ -3,6 +3,7 @@ repo_url: https://github.com/iMicknl/python-overkiz-api
 edit_uri: edit/main/docs/
 
 docs_dir: docs
+copyright: This project is not affiliated with Overkiz, Somfy, or any other mentioned brand. All trademarks and brand names are the property of their respective owners.
 
 extra:
   generator: false
@@ -14,6 +15,7 @@ theme:
     - toc.follow
     - search.suggest
     - search.highlight
+    - navigation.footer
 
 plugins:
   - search
@@ -32,6 +34,7 @@ markdown_extensions:
   - pymdownx.highlight
   - pymdownx.superfences
   - pymdownx.tasklist
+  - admonition
 
 nav:
   - Overview: index.md