Repository navigation
fix(minimal): say DNS, min.internal and box IPs plainly in finalize-install --show - #2166
Merged
norrietaylor merged 3 commits intoOct 11, 2026
Conversation
…nstall --show Reword the names item of 'min finalize-install --show' into the vocabulary a reader already has. The item now says DNS, names <box>.min.internal as the box DNS namespace, names 127.0.64.0/24 as the loopback IPs boxes use (macOS only), splits its missing pieces into short list lines, and drops the internal terms (unit labels, zone, answerer, stub resolver, hook, service manager) from the reader-facing text; 'the command below' becomes 'this step'. Those internal terms remain in '--show --script' and the diagnostic surfaces, which name real files and units. The missing facts become a Vec of short lines; the '; '-joined prose note stays on the cfg(test) advisory path that renders it. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
Member
|
/review |
Contributor
|
Approved: no findings at Nothing to do. Clobber: none: |
…ll --show --json The names item's today field is one line of facts again; the count heading, bullets and indentation are the summary's alone. The heading reads "N things to fix", the Linux step joins the service clause with "and", the range facts drop "one per box", and the refused-source fact no longer names the advisory. Tests pin both platform arms of the step text, the two-fact list and the JSON.
Member
|
/review |
norrietaylor
approved these changes
Oct 11, 2026
norrietaylor
deleted the
inbox-patch/finalize-install-plain-dns-wording-22dc59698cb8802a
branch
October 11, 2026 19:53
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Routing-Key: inbox-route/I_kwDOSUhdos8AAAABWekcxQ
What was wrong. The names item of
min finalize-install --showread in the project's internal vocabulary: "box names for every host program", "box-zone answerer", "reserved local range", "the command below" — terms a reader meeting the install for the first time has no referent for.What changed. The item now says DNS: the label is "DNS names for boxes ((box).min.internal) in every program on this machine"; the missing pieces are short list lines in the summary ("N things to fix:" with one
-fact each;--show --jsonkeepstodayas one line of facts, with no layout in it); the range is "the loopback IPs boxes use (127.0.64.0/24)"; and the step text names what it does plainly. Internal terms (unit labels, zone, answerer, stub resolver, hook, service manager) stay in--show --scriptand the diagnostic surfaces, which name real files and units. The label is one constant shared by both platforms, hence "this machine" rather than the issue's proposed "on this Mac"; the Linux step names systemd-resolved.NamesVerdict::Missing.factsis now aVec<String>of short lines; the"; "-joined prose note stays on the cfg(test) advisory path that renders it.ANSWERER_UNIT_LABEL, orphaned by the rewording, is removed. No docs quote the changed wording (docs/reference/cli-min.md and spec 18 checked), so no doc changes were needed.Verification
cargo fmt --all --manifest-path target/Cargo.tomlthencargo fmt --all --check— cleancargo clippy --workspace --all-targets --locked --manifest-path target/Cargo.toml -- -D warnings— cleanjust test-one "" -p minimalon Linux — 532 passed, 0 failed. The macOS arm of the step text is asserted by tests that only the CI lanes compile.Informed by #546 and #487 (prior naming-rewording precedents).
Not covered
cfg!(target_os), and its macOS arm executes on no lane: the macOS lane tests onlyminvmdandsessions, and the cross build compiles this crate's tests for Linux. The macOS string was checked by hand againstRESERVED_LOCAL_RANGE.Summary by CodeRabbit