Skip to content

Commit 9ef135a

Browse files
andrewjongclaude
andcommitted
hotfix(docs): anchor exclude_docs README pattern to repo root
The exclude_docs entry meant to hide the GitHub-facing repo README used the bare pattern 'README.md'. exclude_docs patterns are gitignore-style, so an unanchored name matches at every depth — silently excluding every README.md the same-dir plugin serves as a docs page. On the published 0.20 site this 404'd the System Test Suite (/tests/), the OSMO Lab Admin Guide (/osmo/), and all autonomy package reference pages, while non-README sources (e.g. tests/ci-cd-orchestrator.md) kept working. Anchor the pattern as '/README.md' so only the repo root is excluded. Verified with a local mkdocs build: tests/, osmo/, and package README pages are generated again and the root URL still serves the redirect. VERSION 0.20.6 -> 0.20.7 with a dated release-notes section per the hotfix rule from #418. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 57027c6 commit 9ef135a

3 files changed

Lines changed: 15 additions & 3 deletions

File tree

‎.env‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ PROJECT_NAME="airstack"
1212
# If you've run ./airstack.sh setup, then this will auto-generate from the git commit hash every time a change is made
1313
# to a Dockerfile or docker-compose.yaml file. Otherwise this can also be set explicitly to make a release version.
1414
# auto-generated from git commit hash
15-
VERSION="0.20.6"
15+
VERSION="0.20.7"
1616
# Image-tag discriminator ONLY (appears in the image tag suffix, e.g. ..._robot-x86-64_dev).
1717
# No Dockerfile consumes it: "prebuilt" does NOT bake the built ros_ws into the image today —
1818
# a real prebuilt (workspace-baked) stage is future work. Keep "dev" (mounted code, built live).

‎docs/release_notes/index.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,15 @@ its own notes. -->
2121

2222
- Nothing yet.
2323

24+
## 0.20.7 — 2026-08-30
25+
26+
- **Fixed 404s on every README-sourced docs page.** The `exclude_docs`
27+
pattern intended to hide the repo-root `README.md` used gitignore
28+
semantics, so it silently excluded *every* `README.md` in the tree —
29+
404ing the System Test Suite (`/tests/`), OSMO Lab Admin Guide
30+
(`/osmo/`), and all autonomy package reference pages. The pattern is
31+
now anchored to the repo root (`/README.md`).
32+
2433
## 0.20.6 — 2026-08-29
2534

2635
- **Release notes now carry a dated section per hotfix.** Added the

‎mkdocs.yml‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,11 @@ site_dir: ../site
66
site_url: "https://docs.theairlab.org/docs/" # Trailing slash is recommended
77
exclude_docs: |
88
# The repo README is GitHub-facing; the site's home page is docs/index.md,
9-
# and same-dir would otherwise collide on the root URL.
10-
README.md
9+
# and same-dir would otherwise collide on the root URL. Patterns are
10+
# gitignore-style: the leading slash anchors this to the repo root only —
11+
# a bare README.md would exclude every package/tests/osmo README the nav
12+
# serves as pages.
13+
/README.md
1114
**/ros_ws/build
1215
**/docker/Foxglove
1316
**/ros_ws/install

0 commit comments

Comments
 (0)