Skip to content

docs: correct first npm dev publish tag guidance - #43

Merged
purpshell merged 1 commit into
devfrom
docs/cli-bootstrap-tag-20260926
Sep 26, 2026
Merged

purpshell merged 1 commit into
devfrom
docs/cli-bootstrap-tag-20260926

Conversation

@purpshell

@purpshell purpshell commented Sep 26, 2026 •

Copy link
Copy Markdown
Member

The first-publish runbook incorrectly warned that npm publish --tag dev might create latest. npm's dist-tag documentation says --tag overrides that default and lists no first-publication exception. The runbook now states the expected tag state and requires checking it after bootstrap. The actual release decision is whether to make the immutable first package version publicly available through @dev and its exact version.

Sources: https://docs.npmjs.com/adding-dist-tags-to-packages/ and https://docs.npmjs.com/cli/v11/commands/npm-dist-tag/ . This changes operator guidance only; it does not publish the package or move a tag.

API and SDK contracts are unaffected. CLI runtime and workflow behavior are unaffected; the existing workflow already uses --tag dev. Public docs remain unchanged because no package has shipped. Feature-release flags, audience, and availability remain unchanged; first publication still needs the npm owner's decision and credential.

Validation: Prettier check for the edited runbook and git diff --check passed. Hosted CI is the final repository gate.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith with what you need. Autofix is disabled.

@coderabbitai

coderabbitai Bot commented Sep 26, 2026

Copy link
Copy Markdown

Warning

Review limit reached

  • Ask an admin to enable usage-based reviews

Open in CodeRabbit

Reviews can continue after your included limit without a manual trigger. An admin must approve usage-based billing.

Next included review available in 56 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available. Your 63 included PR review attempts over the past 7 days set your current allowance at 2 reviews per hour.

The included review limit has been reached and this organization has disabled usage-based review continuation. Wait for reviews to reset or ask a billing admin to change After included review limits.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 69ae2766-5282-4236-b4de-a900e0a4841c

📥 Commits

Reviewing files that changed from the base of the PR and between f18bc8b and 610fcf8.

📒 Files selected for processing (1)
  • internal/npm-prerelease.md

Comment @coderabbitai help to get the list of available commands.

@purpshell
purpshell merged commit 8bacf9f into dev Sep 26, 2026
3 checks passed
@purpshell
purpshell deleted the docs/cli-bootstrap-tag-20260926 branch October 26, 2026 15:52
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