User docs
Narrative user docs distinct from generated reference (byob-output.3). README carries orient-and-quickstart only; --help Long/Example fields carry the detailed reference; narrative docs cover concepts and troubleshooting. Release notes come from git history, not a hand-maintained CHANGELOG.
Decisions
byob-user-docs.1— README is orient-and-quickstart, not a referencebyob-user-docs.2— Reference generated from cobra; narrative docs cover concepts onlybyob-user-docs.3— Invest in `--help` Long descriptions and Example blocksbyob-user-docs.4— Release notes from git history; no hand-maintained CHANGELOGbyob-user-docs.5— Troubleshooting page keyed by ErrHint anchors