Skip to content

docs(relctl): generated CLI reference, sync workflow, 2.11.0 updates and logo - #24

Merged
eksrha merged 2 commits into
mainfrom
docs/relctl-cli-reference-and-logo
Nov 3, 2026
Merged

eksrha merged 2 commits into
mainfrom
docs/relctl-cli-reference-and-logo

Conversation

@eksrha

@eksrha eksrha commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

What

  • CLI reference: docs/relctl/cli/ regenerated with relctl docs --out from the released relctl 2.11.0 binary (relctl_2.11.0_linux-amd64, SHA-256 verified against the release's sha256sum.txt). Stale hand-written content is gone; _category_.json is kept.
  • Workflow sync-cli-reference.yml (weekly, workflow_dispatch, repository_dispatch type relctl-release): fetches the latest published relctl release, verifies the checksum, regenerates the pages and, if they differ, force-updates the branch chore/cli-reference and opens or updates one pull request. Permissions: contents: write, pull-requests: write, plus actions: write only to start CI on the branch (pushes with GITHUB_TOKEN do not trigger CI, but workflow_dispatch is allowed; the run attaches to the branch head commit and shows as a check on the PR). No third-party actions; actions/checkout@v7 as elsewhere in the repo. Not merged automatically.
  • Docs fixes for 2.11.0
    • CalVer is YYYYMM.D.N (day without leading zero) in usage, intro, FAQ and version schemes (was YYYY.MM.DD.N / YYYYMM.DD.N).
    • usage.md: removed the outdated hand-written flag reference (the generated CLI reference replaces it); added pr info per scheme, components and release changed, and the version variables table.
    • configuration.md: tag_prefix and components.
    • version-schemes.md, ci-integration.md, supported-systems.md: RELCTL_VERSION, RELCTL_NEXT_VERSION, RELCTL_LATEST_VERSION, RELCTL_PRERELEASE, RELCTL_TAG, RELCTL_COMPONENT; tag prefix and components.
    • installation.md, ci-integration.md: the manual download used relctl_linux-amd64, which does not exist; assets are named relctl_<version>_<os>-<arch>. The example now resolves the version and checks the SHA-256.
  • Logo: assets under static/img/relctl/; the lockup (dark/light variants) is shown on the relctl intro page. The navbar logo and favicon stay Layer87, because the site is the hub for several products.

Checks (local)

pnpm run typecheck, pnpm run lint:md (0 issues), pnpm run build (no [WARNING]), pnpm test (14 passed, 1 skipped).

… and logo

- Regenerate docs/relctl/cli/ with the released relctl 2.11.0 (relctl docs).
- Add the Sync relctl CLI reference workflow (weekly, manual, repository_dispatch).
- Fix the CalVer format (YYYYMM.D.N); document version variables, tag_prefix,
  components, release changed and pr info per scheme; fix the manual download.
- Add the relctl logo assets and show the lockup on the relctl intro page.
@eksrha
eksrha merged commit dfe5d6c into main Nov 3, 2026
1 check passed
@eksrha
eksrha deleted the docs/relctl-cli-reference-and-logo branch November 3, 2026 09:01
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