mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-09 12:17:13 +00:00
Three classes of drift cleaned up across 85 .md files:
- Em-dashes: replaced ` — ` with the contextually correct separator
(colon for `term: explanation`, period to split clauses across
sentences/source lines, parentheses for asides, semicolon for
tight-linked continuations). Two intentional exceptions remain
in `docs/contributing/documentation.md` (the rule literal) and
inside a fenced ```sh block in `docs/contributing/actions/debugging/ci.md`.
- SPOT self-labels: rewrote "This is the SPOT for X" to describe
the subject directly ("This directory holds X" / "This file
describes X"). Cross-references to other artefacts' canonical
role remain unchanged.
- Heading-emoji position: moved leading-emoji headings (`# 🧩 Title`)
to trailing position (`# Title 🧩`) per the headline rule that
emojis MUST come after the title text.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
21 lines
912 B
Markdown
21 lines
912 B
Markdown
# DNS Helpers
|
|
|
|
This directory holds DNS helpers used during development and environment preparation.
|
|
The folder contains the local name-resolution setup and teardown logic used during development and environment preparation.
|
|
For the canonical Make target index that invokes these helpers, see [make.md](../../../../docs/contributing/tools/make.md).
|
|
|
|
## Areas
|
|
|
|
- [setup/](setup/) for DNS setup scripts
|
|
- [`remove.sh`](remove.sh) for DNS teardown
|
|
- [`common.sh`](common.sh) for shared DNS variables and helper functions
|
|
|
|
## Notes
|
|
|
|
- Canonical domains and aliases come from `roles/*/meta/server.yml`
|
|
- The CLI entrypoint lives in `cli/meta/domains/__main__.py`
|
|
- The reusable generator logic lives in `utils/domains/list.py`
|
|
- `DOMAIN_PRIMARY` is rendered before the list is emitted
|
|
- The DNS fallback calls the generator with `--alias --www`
|
|
- `INFINITO_DNS_HOSTS` can still override the generated list explicitly
|