docs: rewrite the wiki as instructions, and run stop-slop over it
Every page read as an essay. Each section now answers what you type, what
happens, and what to watch out for when that changes what you type.
Deleted throughout: the meta sections about the pages themselves ("Do I need
this page?", "What this page is not", "The five ways this can break you", "Why
the names changed"), the design rationale, the history of what the CLI used to
send, and the postmortem narration that belongs in the repo's docs/solutions.
Prose drops from 59,853 words to 47,515, and no page grew.
Stop-slop pass over all 27 pages:
| marker | before | after |
|---|---|---|
| em dashes in prose | 180 | 0 |
| banned adverbs | 332 | 0 |
| binary contrasts ("not X, it's Y") | 30 | 0 |
| sentences opening on a Wh- word | 25 | 0 |
| throat-clearing phrases | 1 | 0 |
The 139 remaining adverb matches are `also`, `still`, `already` and `exactly`,
none of them on the skill's list, and `still` is load-bearing here: an endpoint
that still answers is the case the refusal wording exists for. The 165 remaining
universal claims are counted or precise ("prepended to every call", "never in a
flag value"), which the rule permits.
Six fabricated transcripts corrected against the binary:
- Ten blocks showed a `message:` label the CLI never prints. On a terminal it
prints the message unlabelled then `hint: `; under `-o json` it prints the
error envelope. Both forms now appear where each applies.
- `jamf-cli pro icons list` was the example for "the retired name warns, then
runs". `pro icon` ships no `list`, so it warned and then exited 2, which is
the opposite of the point. Replaced with `pro icons get 1`.
- The 401, 404 and 429 hints quoted three strings that are not in
`internal/client/client.go`. Replaced with what it emits.
- The payload-verification warning showed one comma-joined line with a
parenthetical. `formatStoredPayloadWarning` emits a header plus one indented
`- path: reason` line per finding, capped at three.
Verbatim CLI output inside code blocks keeps its em dashes and its wording. Five
remain on that basis, two of them in the `pro setup` credential-source menu,
which the CLI itself prints with an em dash.
Structural checks: code fences balanced, no table column mismatches, every
in-page and cross-page anchor resolves after 24 heading renames, and no command,
flag, table row or endpoint lost.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>