Skip to content

docs: add release runbook and document npm install#3

Merged
morningman merged 1 commit into
mainfrom
docs/releasing-npm
May 30, 2026
Merged

docs: add release runbook and document npm install#3
morningman merged 1 commit into
mainfrom
docs/releasing-npm

Conversation

@morningman
Copy link
Copy Markdown
Contributor

What

  • RELEASING.md (new) — a release-manager runbook for publishing the CLI to npm.
  • README.md — adds an Install section presenting npm install -g @apache-doris/doriscli as the recommended install method.

RELEASING.md covers

  • What gets published (the four @apache-doris/* packages) and how npm resolves the right platform binary
  • Versioning — single-sourced from Cargo.toml; npm versions are immutable
  • Prerequisites: a Classic Automation NPM_TOKEN, apache-doris org membership
  • Step-by-step: bump version → dry-run → tag & push → verify
  • How the pipeline works, with a prominent note on the chmod 0755 step (actions/upload-artifact strips the executable bit — this is what made 0.1.0 ship broken) and the Actions-allowlist constraint
  • A troubleshooting table (403 scope / 403 2FA / EACCES / lockfile) and how to recover a broken release

README.md

  • npm install is now the recommended method; build-from-source kept as the fallback.
  • The ## Build heading is unchanged, so existing #build links (npm package README + launcher error message) still resolve.

🤖 Generated with Claude Code

…README

Add RELEASING.md, a release-manager guide for the @apache-doris npm release
process: version source, the Automation-token / scoped-name / chmod
requirements, dry-run validation, tagging, verification, and troubleshooting.

Add an Install section to the README presenting
`npm install -g @apache-doris/doriscli` as the recommended install method,
with build-from-source kept as the fallback.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@morningman morningman merged commit 77703c4 into main May 30, 2026
3 checks passed
@morningman morningman deleted the docs/releasing-npm branch May 30, 2026 09:28
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