Files
computer-playbook/scripts/tests/deploy/local/README.md
T
kevinveenbirkenbachandClaude Opus 5 b291cb7620 feat(docs): report a code span that names a linkable directory
`roles/` set as inline code reads as a literal path, yet the directory
holds an index page the build resolves. Writing it as a link costs nothing
and gives the reader the page; leaving it as code hides it, which is how
this branch degraded six working references in one pass.

The lint strips markdown links from a line before scanning it, or it would
report the code span inside a finished link, and it skips fenced blocks. It
reads the index filenames from the same place the link lint does.

Two false-positive classes came out of the first run and shaped the rule. A
span of nothing but dots and slashes is a path word, not a path: '/' names a
filesystem in a table of mount points and '../' names the traversal an
argument must not perform. An absolute span is skipped because this
repository writes Keycloak group paths that way, and /roles/web-app-bluesky
is a group, not a folder.

35 spans across 12 files become links, and the documentation build resolves
every one of them.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-25 20:09:41 +02:00

15 lines
698 B
Markdown

# Local Deploy Test Scripts 🧪
This file describes the local helpers outside [`deploy/`](deploy/).
For executable local deploy flows, use [deploy/README.md](deploy/README.md).
For inventory reset helpers, use [reset/README.md](reset/README.md).
For cleanup helpers, use [purge/README.md](purge/README.md).
For container exec helpers, use [exec/README.md](exec/README.md).
For the canonical Make target index that invokes these helpers, see [make.md](../../../../docs/contributing/tools/make.md).
## Prerequisites
- Run commands from the repository root.
- Docker and Docker Compose are available locally.
- If you run scripts directly, load the defaults with `source scripts/meta/env/all.sh`.