Skip to content

Npm dist-tag precedence & repository settings updates#421

Open
grainne-cloudsmith wants to merge 11 commits into
mainfrom
docs-334/npm-dist-tag
Open

Npm dist-tag precedence & repository settings updates#421
grainne-cloudsmith wants to merge 11 commits into
mainfrom
docs-334/npm-dist-tag

Conversation

@grainne-cloudsmith
Copy link
Copy Markdown
Contributor

@grainne-cloudsmith grainne-cloudsmith commented May 11, 2026

Updates to the npm format doc:

  • Adds a section on the npm dist-tag precedence setting.
  • Updates references to npm that were incorrectly capitalised.
  • Minor updates to formatting/links/punctuation.

Updates to the Repository Settings doc:

  • Replaces outdated screenshots, removes old features, adds new features, aligns setting descriptions with current UI copy. Adds a few links out to docs for new features.
  • General updates for spelling, grammar, style, and consistency. Aligns wording with latest UI in several places.

Note: 'NPM' still present in a few places where we're directly referencing the UI copy with the same capitalisation.

@vercel
Copy link
Copy Markdown

vercel Bot commented May 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cloudsmith-docs Ready Ready Preview, Comment May 12, 2026 4:08pm

Request Review

@grainne-cloudsmith grainne-cloudsmith changed the title Adding info on the npm dist-tag precedence setting. Npm dist-tag precedence & repository settings updates May 12, 2026
@grainne-cloudsmith grainne-cloudsmith marked this pull request as ready for review May 12, 2026 15:50
Copilot AI review requested due to automatic review settings May 12, 2026 15:50
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates Cloudsmith documentation to reflect current repository settings behavior and clarifies npm dist-tag handling (including upstream precedence) for users configuring npm repositories.

Changes:

  • Reworks the Repository Settings doc with updated screenshots, renamed sections, and expanded setting descriptions (including “NPM upstream tags take precedence”).
  • Updates the npm Registry doc for improved accuracy/wording around distribution tags and adds a new “Upstream Tag Precedence” section.

Reviewed changes

Copilot reviewed 2 out of 14 changed files in this pull request and generated 6 comments.

File Description
src/content/repositories/repository-settings.mdx Refreshes repository settings documentation, screenshots, and adds/clarifies settings including npm upstream dist-tag precedence.
src/content/formats/npm-registry.mdx Improves wording/accuracy and adds guidance on upstream dist-tag precedence behavior for npm.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread src/content/repositories/repository-settings.mdx Outdated

**Use Debian repository labels**

If checked, a `Label` field will be present in Debian-based repositories. It will contain a string that identifies the entitlement token used to authenticate the repository, in the form of `source=t-`, or `source=none` if no token was used. You can use this to help with pinning.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For reviewer input - I'd updated this to align with the latest UI copy. Worth reverting?

Comment thread src/content/repositories/repository-settings.mdx Outdated
Comment thread src/content/formats/npm-registry.mdx Outdated
Comment thread src/content/formats/npm-registry.mdx Outdated
Comment thread src/content/formats/npm-registry.mdx Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants