From 7d70cf6ea5ddf5e52c0a549857b707d24dea2046 Mon Sep 17 00:00:00 2001 From: brutsalvadi Date: Fri, 8 May 2026 10:09:05 +0200 Subject: [PATCH] Document mkdocs serve/build commands in getting-started --- docs/development/getting-started.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) 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 # updates pyproject.toml and uv.lock +uv add # runtime dep — updates pyproject.toml and uv.lock +uv add --group docs # docs-only dep ``` ## Adding JS dependencies