docs(dlc-live-gui): refine docs and install quickstart

Clean up and improve DeepLabCut-Live! GUI docs: remove an inline TOC note, add a caution block and section anchor for limitations, and clarify/current-limitations wording and performance guidance. Improve quickstart and install pages with a tip, clearer hardware/backend bullet formatting, an explicit pip torch install example for CUDA, and simplify installation commands. Minor copyedits for clarity and contribution/feedback section formatting.
C-Achard · Mar 9, 2026 · Feb 6, 2026 · Feb 6, 2026 · Feb 6, 2026 · Feb 6, 2026
commit d0344501fa13f2ab83481b54825714cc21640c75
diff --git a/_toc.yml b/_toc.yml
@@ -86,9 +86,6 @@ parts:
 - caption: DeepLabCut-Live!
   chapters:
   - file: docs/dlc-live/deeplabcutlive
-  # NOTE @C-Achard Please move if needed, but since it is downstream of DLC-live
-  # I think it makes sense to have it here for now.
-  # TODO remove this note before merging
   - file: docs/dlc-live/dlc-live-gui/index
     sections:
       - file: docs/dlc-live/dlc-live-gui/quickstart/install

diff --git a/docs/dlc-live/dlc-live-gui/index.md b/docs/dlc-live/dlc-live-gui/index.md
@@ -11,6 +11,10 @@ This GUI is designed for **scientists and experimenters** who want to preview, r
 - {doc}`Camera setup and backends <./user_guide/cameras_backends/camera_support>`
 - {doc}`Timestamp format and synchronization <./user_guide/misc/timestamp_format>`
 
+```{caution}
+Please be aware of the {ref}`sec:dlclivegui-index-limitations`
+```
+
 ---
 
 ## Description
@@ -47,24 +51,25 @@ and *{doc}`User Guide <user_guide/overview>`* sections of this documentation.
 - Anyone who wants a **GUI-first** workflow for DeepLabCut Live
 
 ---
-
+(sec:dlclivegui-index-limitations)=
 ## Current limitations
 
 Before getting started, be aware of the following constraints:
 
 - Pose inference runs on **one selected camera at a time** (even in multi-camera mode)
-- Camera synchronization depends on backend capabilities and hardware
+- Camera synchronization depends on **backend capabilities and hardware**
   - OpenCV controls for resolution and FPS are "best effort" and may not work with all cameras.
     Expect inconsistencies when setting certain frame rates or resolutions as resolution depends on the device driver.
 - DeepLabCut Live models must be **exported and compatible** with the selected backend
-  - Some SuperAnimal models from {ref}`file:model-zoo` may not work out of the box.<br>This is currently the case for:
+  - Some SuperAnimal models from {ref}`file:model-zoo` may not work out of the box.<br>This is currently a known issue for:
     - SuperHuman model (missing detector)
-- Performance depends on camera resolution, frame rate, GPU availability, and codec choice
+- **Performance** depends on camera resolution, frame rate, GPU availability, and codec choice
+  - Expect bottlenecks with heavy models, multiple high-resolution cameras, or CPU-only inference.
 
 ---
 
-## About
-
-*This project is under active development. Feedback from real experimental use is highly valued.*
+## Feedback, issues, and contributions
 
-[Please report issues, suggest features, or contribute to the codebase on GitHub !](https://github.com/DeepLabCut/DeepLabCut-live-GUI)
+> *This project is under active development. Feedback from real experimental use is highly valued.*
+> 
+> [Please report issues, suggest features, or contribute to the codebase on GitHub !](https://github.com/DeepLabCut/DeepLabCut-live-GUI)
diff --git a/docs/dlc-live/dlc-live-gui/quickstart/install.md b/docs/dlc-live/dlc-live-gui/quickstart/install.md
@@ -4,6 +4,10 @@ This page explains how to install **DeepLabCut-live-GUI** for interactive, real
 
 We support various installation methods, including `uv` and `mamba`/`conda`.
 
+```{tip}
+If you feel confident you meet the requirements and you just want to get started quickly, see the {ref}`sec:dlclivegui-install-quickstart` section below.
+```
+
 ---
 
 ## System requirements
@@ -25,10 +29,10 @@ We support various installation methods, including `uv` and `mamba`/`conda`.
 ### Hardware requirements
 
 - Any **compatible camera** (see *{ref}`file:dlclivegui-camera-support`*):
-  - USB webcam, OBS virtual camera → OpenCV-compatible cameras are supported by default
-  - Basler
-  - GenTL
-  - Aravis
+  - **USB webcam, OBS virtual camera** → OpenCV-recognized cameras are accessible by default
+  - **Basler**
+  - *GenTL [^exp]*
+  - *Aravis [^exp]*
 - Optional but recommended:
   - **CUDA-capable GPU** (for real‑time inference)
   - NVIDIA drivers compatible with your PyTorch/TensorFlow version
@@ -46,24 +50,25 @@ If you use an OpenCV-compatible camera (e.g. USB webcam, OBS virtual camera), yo
 - A working camera backend (see *{ref}`file:dlclivegui-camera-support`*)
 
 ---
-
+(sec:dlclivegui-install-quickstart)=
 ## Quickstart (recommended defaults)
 
 ```bash
 git clone https://github.com/DeepLabCut/DeepLabCut-live-GUI.git
 cd DeepLabCut-live-GUI
 uv venv
 source .venv/bin/activate   # Windows: see tabs below
+uv pip install torch torchvision --index-url https://download.pytorch.org/whl/cu<your-cuda-version> # e.g. cu128 for CUDA 12.8, or skip for CPU-only
 uv pip install -e ".[pytorch]"
 dlclivegui
 ```
 
 ## Choose your installation method
 
-Below instructions cover installation with `uv` and `mamba`/`conda`, but you can also install with other package managers like `pdm` if you prefer.
+Below instructions cover installation with `uv` and `mamba`/`conda`, but you may also install with other package managers like `pdm` if preferred.
 
 ```{note}
-The entire DeepLabCut package and its GUI are not required to use this software, as it is designed to be a lightweight interface for real‑time pose estimation.
+The main DeepLabCut package and its GUI are not required to use this software, as it is designed to be a lightweight interface for real‑time pose estimation.
 ```
 
 ### Install DeepLabCut-live-GUI
@@ -113,7 +118,7 @@ uv venv -p 3.12 # or desired Python version
 ##### Choose inference backend
 
 We offer two distinct inference backends: **PyTorch** and **TensorFlow**.
-You can install either or both, but you must** choose at least one** to run the pose estimation models.
+You may install either or both, but you must **choose at least one** to run the pose estimation models.
 
 `````{tab-set}
 
@@ -155,7 +160,7 @@ conda activate dlclivegui
 ##### Choose inference backend
 
 We offer two distinct inference backends: **PyTorch** and **TensorFlow**.
-You can install either or both, but you must** choose at least one** to run the pose estimation models.
+You may install either or both, but you must **choose at least one** to run the pose estimation models.
 
 `````{tab-set}
 
@@ -165,7 +170,7 @@ To **enable GPU support** and obtain detailed installation instructions,
 please refer to the [official PyTorch installation guide](https://pytorch.org/get-started/locally/).
 ```
 ```bash
-uv pip install -e ".[pytorch]"
+pip install -e ".[pytorch]"
 ```
 ````
 
@@ -175,7 +180,7 @@ Please note TensorFlow is **no longer available** on **Windows** for **Python >
 ```
 
 ```bash
-uv pip install -e ".[tf]"
+pip install -e ".[tf]"
 ```
 ```{note}
 For detailed installation instructions, please refer to the [official TensorFlow installation guide](https://www.tensorflow.org/install/pip).
@@ -202,3 +207,5 @@ dlclivegui # OR uv run dlclivegui
 ```{important}
 Make sure your venv or conda environment is activated before running the application, so it can access the installed dependencies.
 ```
+
+[^exp]: Support for this backend is currently experimental and may not work out of the box. Please refer to the backend-specific documentation for details and troubleshooting tips, and report any issues you encounter on GitHub to help us improve support for these backends.
diff --git a/docs/dlc-live/dlc-live-gui/user_guide/overview.md b/docs/dlc-live/dlc-live-gui/user_guide/overview.md
@@ -37,7 +37,7 @@ To start running an experiment, the typical workflow is:
 
 1. **Configure Cameras**
    - Use **Configure Cameras…** to select one or more cameras and their parameters.
-     See {ref}`file:dlclivegui-camera-support` for details on supported camera backends and troubleshooting.
+   - See {ref}`file:dlclivegui-camera-support` for details on supported camera backends and troubleshooting.
 
 2. **Start Preview**
    - Click **Start Preview** to begin streaming all selected configured cameras.

diff --git a/uv.lock b/uv.lock