diff --git a/docs/development/getting-started.md b/docs/development/getting-started.md
index 2d1e4b3..485e39b 100644
--- a/docs/development/getting-started.md
+++ b/docs/development/getting-started.md
@@ -42,10 +42,23 @@ bash scripts/dev.sh --edit
 
 The Astro dev server proxies all `/api/`, `/pages/`, `/stories/`, `/assets/`, and `/rebuild` requests to `http://localhost:8001`.
 
+## Browsing this documentation
+
+The docs dependency group is declared in `pyproject.toml` and is separate from the runtime dependencies.
+
+```bash
+# Live-reload server at http://127.0.0.1:8000
+uv run --group docs mkdocs serve
+
+# Build static output to site/
+uv run --group docs mkdocs build
+```
+
 ## Adding Python dependencies
 
 ```bash
-uv add <package>   # updates pyproject.toml and uv.lock
+uv add <package>          # runtime dep — updates pyproject.toml and uv.lock
+uv add --group docs <package>  # docs-only dep
 ```
 
 ## Adding JS dependencies