Skip to content

docs: backfill missing CLI commands in cli-reference.md - #223

Open
ke23y wants to merge 1 commit into
marcus:mainfrom
ke23y:docs/backfill-cli-reference
Open

docs: backfill missing CLI commands in cli-reference.md#223
ke23y wants to merge 1 commit into
marcus:mainfrom
ke23y:docs/backfill-cli-reference

Conversation

@ke23y

@ke23y ke23y commented Aug 21, 2026

Copy link
Copy Markdown

Summary

  • website/docs/cli-reference.md documented only 10 of the 16 top-level nightshift commands actually registered in cmd/nightshift/commands (per the AddCommand calls in root.go/each command file).
  • Adds the missing commands — config (get/set/validate), init, install/uninstall, report, and busfactor — to the Core Commands table.
  • Adds new ## Config Commands, ## Project Setup Commands, and ## Reporting Commands sections with example usage and flag tables, sourced from each command's actual Use/Short/Long text and cobra flag definitions in the corresponding .go files.
  • Cross-references docs/bus-factor.md for detailed bus-factor metric explanations, matching how busfactor is already documented elsewhere (docs/bus-factor.md, website/docs/scheduling.md, troubleshooting.md).

Test plan

  • Manually cross-checked each documented flag/default against the cobra.Command and Flags() definitions in config.go, init.go, install.go, report.go, and busfactor.go.
  • Visually reviewed the updated cli-reference.md for formatting consistency (tables, code blocks, headers) with existing sections.
  • cd website && npm install && npm run build — not run in this environment (no network-fetched node_modules); recommend running in CI before merge.

🤖 Generated with Claude Code


Automated by nightshift

cli-reference.md documented only 10 of the 16 top-level nightshift
commands actually registered in cmd/nightshift/commands (root.go
AddCommand calls). Add config (get/set/validate), init,
install/uninstall, report, and busfactor to the Core Commands table
and add new Config Commands, Project Setup Commands, and Reporting
Commands sections, sourced from each command's actual Use/Short/Long
and cobra flag definitions.

Nightshift-Task: docs-backfill
Nightshift-Ref: https://github.com/marcus/nightshift
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