Skip to content

Restructure README into focused topic docs#298

Merged
AndreyVMarkelov merged 1 commit into
masterfrom
docs/restructure-readme
Jun 28, 2026
Merged

Restructure README into focused topic docs#298
AndreyVMarkelov merged 1 commit into
masterfrom
docs/restructure-readme

Conversation

@AndreyVMarkelov

@AndreyVMarkelov AndreyVMarkelov commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Condenses README into a concise landing page (~170 lines) with quickstart, common workflows, features, installation, and links to deeper docs.
  • Extracts detailed content into docs/automation.md (JSON output, auth, piping, exit status) and docs/sharing.md (shared-link workflows).
  • Enriches generated command docs with a "Command metadata" section (structured output support, stdin/stdout behavior, destructive level).
  • Uses absolute GitHub URLs for doc links so they work outside the repo (pkg.go.dev, Homebrew).

Test plan

  • go test ./... -count=1 passes
  • golangci-lint run ./... clean
  • go run ./tools/gen-docs output matches committed docs/commands/
  • Verify README, automation.md, and sharing.md render correctly on GitHub
  • CI passes

Condense the README into a concise landing page with quickstart, common
workflows, features, and installation. Move detailed content into
docs/automation.md (JSON output, auth, piping, exit status) and
docs/sharing.md (shared-link workflows). Enrich generated command docs
with a metadata section showing structured output support, stdin/stdout
behavior, and destructive level.
@AndreyVMarkelov AndreyVMarkelov merged commit 36902a3 into master Jun 28, 2026
8 checks passed
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