vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

treefmt: a generated CLI doc is the generator's, not prettier's

Browse source 
docs/tools/swarmctl-cli.md is rendered by `swarmctl markdown-docs`, and
nix/checks.nix's swarmctl-docs-fresh check diffs the committed copy
against fresh binary output. Enabling prettier on markdown rewrote its
list bullets and footer indentation, which no regeneration can settle:
formatting it fails the freshness check, not formatting it fails
treefmt. .prettierignore already carried hivectl-cli.md for exactly
this reason; swarmctl's doc was added later and the entry was not.

Restore the file to its generated bytes, list it alongside hivectl's,
and state the invariant where the next CLI doc gets added.
This commit is contained in:
atlas 2026-09-02 15:23:56 +02:00
commit cc2503d9c7
3 changed files with 49 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

10
.prettierignore
View file

@ -1,7 +1,11 @@
# Auto-generated by `hivectl markdown-docs` — do not format.
# The hivectl-docs CI check diffs this against fresh binary output,
# so reformatting it would break that check.
# Generated by `<tool> markdown-docs` — do not format. The matching
# *-docs-fresh check in nix/checks.nix diffs each against fresh binary
# output, so any reformatting fails that check permanently: the
# generator, not the formatter, owns these files' layout. Every CLI
# reference doc belongs here — adding one and forgetting this line is
# what made swarmctl's fail.
docs/tools/hivectl-cli.md
docs/tools/swarmctl-cli.md
# Files with multi-line list-item continuations that prettier strips to col 0.
# prettier's `proseWrap: "preserve"` prevents prose reflow but not list-item