cleanup docs text

Co-authored-by: Copilot <copilot@github.com>

Author: lorenzocerrone

README.md

@@ -1,6 +1,6 @@
 # ngio Workshop
 
-Hands-on workshop materials for [ngio](https://github.com/fractal-analytics-platform/ngio), a Python library for reading and writing OME-Zarr / NGFF bioimages. Notebooks are built with [marimo](https://marimo.io) for an interactive, reproducible experience.
+Hands-on workshop materials to get started with [ngio](https://biovisioncenter.github.io/ngio). ngio is a Python library designed to simplify bioimage analysis workflows, offering an intuitive interface for working with OME-Zarr files.
 
 Each notebook is self-contained: it declares its own dependencies inline and marimo uses [uv](https://docs.astral.sh/uv/) to create an isolated environment automatically.
 
@@ -20,18 +20,18 @@ uvx marimo edit --sandbox notebooks/<notebook>.py
 
 On first run uv will create an isolated environment for the notebook and install its dependencies. This takes a minute; subsequent runs are instant.
 
+## Workshop modules
+
+| Module | Topic |
+|--------|-------|
+| [1 — Introduction to ngio](notebooks/1_ngio_basics.py) | OME-Zarr containers, images, labels, and tables |
+
 ## Documentation
 
-Live notebooks (read-only): https://&lt;your-org&gt;.github.io/ngio-workshop/
+You can find view a static version of the notebooks in the [documentation](https://biovisioncenter.github.io/ngio-workshop/).
 
-To build docs locally:
+Or you can build the documentation locally with:
 
 ```bash
 uv run docs/build.py
 ```
-
-## Workshop modules
-
-| Module | Topic |
-|--------|-------|
-| [1 — Introduction to ngio](notebooks/1_ngio_basics.py) | OME-Zarr containers, images, labels, and tables |

docs/index.html

@@ -12,27 +12,35 @@
       <div class="badge">Workshop</div>
       <h1>ngio Workshop</h1>
       <p class="subtitle">
-        Hands-on notebooks for <a href="https://github.com/fractal-analytics-platform/ngio">ngio</a>,
-        a Python library for reading and writing OME-Zarr bioimages.
+        Hands-on notebooks for learning the basics of <a href="https://github.com/fractal-analytics-platform/ngio">ngio</a>.
       </p>
     </div>
   </header>
 
   <main>
     <section class="install">
-      <div class="section-label">Installation</div>
+      <div class="section-label">Running the Notebooks</div>
       <div class="install-block">
-        <p>Install <strong>ngio</strong> with pip:</p>
-        <pre><code>pip install ngio</code></pre>
-        <p>Or with uv:</p>
-        <pre><code>uv add ngio</code></pre>
+        <p>The notebooks are self-contained and manage their own dependencies. You only need <a href="https://docs.astral.sh/uv/">uv</a> installed.</p>
+        <p>Clone the repository:</p>
+        <pre><code>git clone https://github.com/fractal-analytics-platform/ngio-workshop.git
+cd ngio-workshop</code></pre>
+        <p>Run a notebook interactively:</p>
+        <pre><code>uvx marimo run --sandbox notebooks/1_ngio_basics.py</code></pre>
+        <p>Or open it for editing:</p>
+        <pre><code>uvx marimo edit --sandbox notebooks/1_ngio_basics.py</code></pre>
       </div>
     </section>
 
     <section class="notebooks">
       <div class="section-label">Notebooks</div>
       <div class="nb-list">
         <!-- notebooks:start -->
+        <a class="nb-card" href="1_ngio_basics.html">
+          <span class="nb-num">1</span>
+          <span class="nb-title">Introduction to ngio</span>
+          <span class="nb-arrow">&#8594;</span>
+        </a>
         <!-- notebooks:end -->
       </div>
     </section>