Skip to content

docs(readme): rewrite README for the current CLI - #213

Merged
ysyneu merged 1 commit into
mainfrom
docs/readme-refresh
Oct 9, 2026
Merged

ysyneu merged 1 commit into
mainfrom
docs/readme-refresh

Conversation

@ysyneu

@ysyneu ysyneu commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

Summary

The README had drifted from the code: it listed the removed flashduty-sdk dependency, required Go 1.24+ (go.mod is 1.26), covered about ten of the 37 command groups with some outdated names, and linked only flashcat.cloud.

  • Rewrote README.md and README_zh.md (kept in step).
  • Intro and links: a keyword-bearing intro, plus links to the website, CLI docs, API reference, console, blog post, releases, and related projects. Uses the www.flashduty.com and docs.flashduty.com domains.
  • Commands: a command-group overview by product area and the path-to-command rule, instead of a hand-maintained per-command list. --help and the docs carry the long tail.
  • Dependencies: the table now lists go-flashduty, cobra, toon-go, yaml.v3, and x/term.
  • Newly documented: whoami, update, the environment variables the CLI reads, and the field-coverage test for curated commands.

Verification

  • Every command and flag shown in the README exists in the v1.5.12 binary (--help exits 0).
  • Every external link returns HTTP 200.

- Drop the removed flashduty-sdk dependency; list go-flashduty, cobra,
  toon-go, yaml.v3 and x/term.
- Replace the hand-maintained command list (which covered about ten of
  the 37 groups and used outdated names) with a group overview by product
  area and the path-to-command rule, and point to --help and the docs
  for the long tail.
- Link the website, CLI docs, API reference, console, blog post and
  related projects; use the flashduty.com and docs.flashduty.com domains.
- Document whoami, update, the environment variables the CLI reads, and
  the Go 1.26 requirement; refresh the version example to v1.5.12.
- Keep README.md and README_zh.md in step.
@ysyneu
ysyneu merged commit f02e866 into main Oct 9, 2026
12 checks passed
@ysyneu
ysyneu deleted the docs/readme-refresh branch October 9, 2026 05:27
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