docs: Update installation guide

Author: fischeti

docs/floogen/installation.md

@@ -1,92 +1,109 @@
 # Installation
 
-_FlooGen_ is distributed as a standard Python package. It provides the `floogen` command-line interface (CLI) to generate your networks.
-
-!!! note "PyPI Availability"
-    _FlooGen_ is currently **not** published on PyPI. You must clone the repository and install it locally from the source.
+_FlooGen_ is distributed as a standard Python package available on PyPI. It provides the `floogen` command-line interface (CLI) to generate your networks.
 
 ## Prerequisites
 
 - **Python**: Version 3.10 or higher.
-- **Git**: To clone the repository.
+- **Git**: To clone the repository (only required for source installation).
 
+---
 
-First, clone the _FlooNoC_ repository:
+## Install from PyPI
 
-```bash
-git clone https://github.com/pulp-platform/FlooNoC.git && cd FlooNoC
-```
-
-Then install _FlooGen_ using with either `uv` or `pip`. We recommend using [uv](https://github.com/astral-sh/uv) for installation. It is significantly faster than `pip` and automatically manages virtual environments and dependencies for you, keeping your system Python clean. However, if you prefer the standard Python workflow, `pip` works just as well.
+If you just want to use the tool to generate networks, install it directly from PyPI with either [`uv`](https://github.com/astral-sh/uv) (recommended) or `pip`.
 
 === "uv"
 
+    **To install globally (recommended):**
+    This makes the `floogen` command available everywhere in your terminal.
+    ```bash
+    uv tool install floogen
+    # and verify installation
+    floogen --help
+    ```
 
-
-    1.  **Install uv** (if you haven't already):
-        ```bash
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        ```
-    2.  **Run with uv**:
-        You can run _FlooGen_ directly in an ephemeral environment without manual installation:
-        ```bash
-        uv run floogen --help
-        ```
+    **To run without installing (ephemeral):**
+    You can run _FlooGen_ instantly without cluttering your system:
+    ```bash
+    uvx floogen --help
+    ```
 
 === "pip"
 
-    1.  **Create and activate a virtual environment** (optional but recommended):
+    1.  **Create and activate a virtual environment** (recommended):
         ```bash
         python3 -m venv .venv
         source .venv/bin/activate
         ```
 
     2.  **Install the package**:
         ```bash
-        pip install .
+        pip install floogen
         ```
+        
+    3.  **Verify installation:**
+        ```bash
+        floogen --help
+        ```
+        
+---
+
+## Install from Source
 
-## Verification
+Use this method if you need to modify _FlooGen_, contribute to the project, or if you are working with the full _FlooNoC_ hardware repository.
 
-To verify that the installation was successful, try running the help command. You should see the CLI usage information.
+First, clone the _FlooNoC_ repository:
+
+```bash
+git clone https://github.com/pulp-platform/FlooNoC.git && cd FlooNoC
+```
 
 === "uv"
+
+    When using `uv` inside the repository, no manual installation step is strictly necessary. `uv` will automatically detect the project configuration.
+    
     ```bash
     uv run floogen --help
     ```
 
+    _This command will automatically set up the environment and install dependencies defined in `pyproject.toml`._
 === "pip"
-    ```bash
-    floogen --help
-    ```
-
-## Development & Documentation
-
-If you plan to contribute to _FlooGen_ or build the documentation locally, you should install the optional dependencies.
-
-=== "uv"
-    ```bash
-    # Nothing to do, `uv run` will download dependencies automatically
-    ```
 
+    1.  **Create and activate a virtual environment**:
+        ```bash
+        python3 -m venv .venv
+        source .venv/bin/activate
+        ```
+    
+    2.  **Install in editable mode**:
+        ```bash
+        pip install -e .
+        ```
 
-=== "pip"
-    ```bash
-    pip install .[dev]
-    ```
+## Documentation
 
-The documentation is built using [Zensical](https://zensical.org/). To build the documentation locally, run:
+The documentation is built using [`zensical`](https://zensical.org/), which is defined as a development dependency. To build it you can run:
 
 === "uv"
     ```bash
     uv run zensical build
     ```
+    
+    _The development dependencies are implicit in `uv` i.e. `uv run --group dev` is not necessary._
 
 === "pip"
-    ```bash
-    zensical build
-    ```
-
+    1.  **Create and activate a virtual environment** (if not already done):
+        ```bash
+        python3 -m venv .venv
+        source .venv/bin/activate
+        ```
+        
+    2.  **Install the development dependencies**:
+        ```bash
+        pip install .[dev]
+        ```
+    
 If you want to serve the documentation locally for easier browsing, run:
 
 === "uv"