mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-07 19:32:17 +00:00
RFC 6761 reserves .test for testing and .example for documentation, and the project's own domain was doing both jobs under the documentation name. It is what default.env hands every local deploy and what the test fixtures assert against, so it is a testing name. Rename it wherever it stands for the running machine: the environment defaults, the development inventory, the workspace and trust scripts, the test suites, and the four documents that describe real behaviour - the DNS mapping to loopback, the browser CA trust, WSL2 resolution. Those documents would have started lying the moment default.env changed. The sandbox allowlist moves with them, since egress is matched per pattern and nothing resolves the old name any more, and the sandbox document that mirrors that list follows it. Two places keep .example on purpose: the link-style sample in the documentation guide, which is documentation about documentation, and every generic fixture name elsewhere in the suite - a.example, foo.example and their kin. Those are a larger sweep of their own and are not touched here. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.
Areas
- setup/ for DNS setup scripts
remove.shfor DNS teardowncommon.shfor 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_PRIMARYis rendered before the list is emitted- The DNS fallback calls the generator with
--alias --www INFINITO_DNS_HOSTScan still override the generated list explicitly