Skip to content

docs: comprehensive CLI help text for all commands#5

Merged
ancongui merged 1 commit into
developfrom
docs/comprehensive-cli-help-text
Feb 10, 2026
Merged

docs: comprehensive CLI help text for all commands#5
ancongui merged 1 commit into
developfrom
docs/comprehensive-cli-help-text

Conversation

@ancongui
Copy link
Copy Markdown
Contributor

Summary

  • Added detailed Long descriptions with phases, examples, and flag explanations for all 12 CLI commands and their subcommands (setup, create, doctor, update, build, publish, dag show/layers/affected/export, fwversion show/bump/check/families, config get/set/reset, upgrade, run, version)
  • Added root command overview listing all available commands with brief descriptions
  • Added missing flywork run section to README with full documentation and flags table
  • Fixed README config table: parent_version default corrected from 1.0.0-SNAPSHOT to 26.01.01, added missing branch key
  • Fixed repository count from 34 to 38 to match actual DAG graph
  • Added flags tables for setup, create, update, build, publish, and upgrade in README
  • Added global flags section documenting -v/--verbose and -h/--help
  • Added run.go and internal/runner to project structure in README

Test plan

  • go build ./... passes
  • go vet ./... passes
  • go test ./... passes
  • All help text is accurate and matches actual code behavior (no fake information)
  • All flags, options, and subcommands are documented

… gaps

- Add detailed Long descriptions with phases, examples, and flag explanations
  for all 12 commands and their subcommands (setup, create, doctor, update,
  build, publish, dag, fwversion, config, upgrade, run, version)
- Add root command overview listing all available commands with descriptions
- Add missing flywork run section to README with flags table
- Fix README config table: parent_version default 26.01.01, add branch key
- Fix README repo count from 34 to 38 to match actual DAG
- Add flags tables for setup, create, update, build, publish, upgrade in README
- Add global flags section documenting -v/--verbose and -h/--help
- Add run.go and internal/runner to project structure in README
@ancongui ancongui enabled auto-merge (squash) February 10, 2026 22:24
@ancongui ancongui merged commit 3e286e7 into develop Feb 10, 2026
2 checks passed
@ancongui ancongui deleted the docs/comprehensive-cli-help-text branch February 10, 2026 22:25
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