Page or section
https://docs.stacklok.com/toolhive/guides-cli/network-isolation (docs/toolhive/guides-cli/network-isolation.mdx)
What could be better?
- The
:::info[Changed in v0.40.0] admonition (~line 224) mostly duplicates the behavior table directly above it, and the old behavior it describes was a bug (silently broken DNS for host-networked workloads), so the "if you relied on the previous behavior" audience is near zero.
- Line ~214: "In v0.40.0 and later, ToolHive reconciles the two flags automatically" leaks version framing into body prose.
Proposal
Trim the admonition to the one genuinely new fact or remove it entirely, and reword line 214 to "ToolHive reconciles the two flags automatically." The nearby :::info[Changed in v0.30.1] admonition (isolation on by default) is still valid per the breaking-change exception in the style guide; leave it in place for now.
Page or section
https://docs.stacklok.com/toolhive/guides-cli/network-isolation (
docs/toolhive/guides-cli/network-isolation.mdx)What could be better?
:::info[Changed in v0.40.0]admonition (~line 224) mostly duplicates the behavior table directly above it, and the old behavior it describes was a bug (silently broken DNS for host-networked workloads), so the "if you relied on the previous behavior" audience is near zero.Proposal
Trim the admonition to the one genuinely new fact or remove it entirely, and reword line 214 to "ToolHive reconciles the two flags automatically." The nearby
:::info[Changed in v0.30.1]admonition (isolation on by default) is still valid per the breaking-change exception in the style guide; leave it in place for now.