Skip to content

docs: documentation pass across README, runbooks, and rustdoc#59

Merged
lunarthegrey merged 3 commits into
mainfrom
docs/clarity-pass
May 19, 2026
Merged

docs: documentation pass across README, runbooks, and rustdoc#59
lunarthegrey merged 3 commits into
mainfrom
docs/clarity-pass

Conversation

@lunarthegrey
Copy link
Copy Markdown
Contributor

Summary

  • Reword the README and the example config so the directive index and inline guidance read as plain prose.
  • Restructure the "Known gaps" section of the custom-FIB runbook: the items in that list had shipped, so they move into a "Resolved items" subsection that doubles as a short changelog.
  • Tighten inline rustdoc and clap --help text across the workspace. Drops a few internal spec/PR references from user-facing CLI help and the probe crate's crates.io description; module-internal references are kept.

Test plan

  • CI green: fmt + clippy + workspace tests + four cross-builds + qemu-verifier matrix
  • packetframe --help and each subcommand --help render cleanly with no internal-doc artifacts
  • README renders correctly on github.com (the "Quick directive index" and the status table in particular)
  • custom-fib runbook renders with a "Resolved items" subsection

🤖 Generated with Claude Code

lunarthegrey and others added 3 commits May 19, 2026 03:59
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The "Known gaps" section had drifted to track features that had since
shipped. Rename to "Resolved items" and drop the status glyphs; the
entries stay as a changelog of what landed when.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Rephrase prose comments and clap --help text for clarity. Drop a few
internal spec/PR references from user-facing CLI help and the probe
crate's crates.io blurb; internal module-doc references are retained.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@lunarthegrey lunarthegrey merged commit 2b0a033 into main May 19, 2026
14 of 15 checks passed
@lunarthegrey lunarthegrey deleted the docs/clarity-pass branch May 19, 2026 18:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant