Skip to content

Document EP version picker fallback behavior#4185

Merged
NoaheCampbell merged 2 commits into
mainfrom
ep-version-picker-fallback-docs
Jun 16, 2026
Merged

Document EP version picker fallback behavior#4185
NoaheCampbell merged 2 commits into
mainfrom
ep-version-picker-fallback-docs

Conversation

@NoaheCampbell

Copy link
Copy Markdown
Contributor

Documents the Enterprise Portal version picker behavior for releases that do not have matching content branches.

This adds guidance for the new Require matching content for release versions setting, including when vendors should leave fallback behavior enabled and when they should require explicit version-specific content.

@NoaheCampbell NoaheCampbell requested a review from a team as a code owner June 16, 2026 14:12
@netlify

netlify Bot commented Jun 16, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit bb851c3
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a315b27fe2bb00008db4c11
😎 Deploy Preview https://deploy-preview-4185--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Jun 16, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit bb851c3
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a315b276e12080008e4cd93
😎 Deploy Preview https://deploy-preview-4185--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels Jun 16, 2026

1. **Pin override**: If the vendor has pinned this release to a specific branch, that branch's content is used. Pins always take priority.
1. **Exact match**: If a branch exists with the same name as the selected version (e.g., branch `2.0.0` for version `2.0.0`), that branch's content is used.
1. **Pin override**: If the vendor has pinned this release to a specific branch, that branch's content is used. Pins count as exact matches for version-picker filtering.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('is used').

1. **Pin override**: If the vendor has pinned this release to a specific branch, that branch's content is used. Pins always take priority.
1. **Exact match**: If a branch exists with the same name as the selected version (e.g., branch `2.0.0` for version `2.0.0`), that branch's content is used.
1. **Pin override**: If the vendor has pinned this release to a specific branch, that branch's content is used. Pins count as exact matches for version-picker filtering.
1. **Exact or normalized match**: If a branch has the same name as the selected version, that branch's content is used. For example, branch `2.0.0` matches version `2.0.0`. Enterprise Portal also handles a `v` prefix mismatch.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('is used').

To remove a version's dedicated content branch, delete the branch from your git repo. The branch disappears from the Content tab after the next sync.

However, if a release with that version label still exists on a customer's channel, the version still appears in the customer's version dropdown. The portal resolves it using the version resolution chain (nearest lower semver branch, then `main` as fallback). To fully remove a version from the customer's dropdown, the release must also be removed from the channel.
However, if a release with that version label still exists on a customer's channel, the version still appears in the customer's version dropdown by default.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Replicated.SentenceLength] Try to keep your sentence length to 26 words or fewer.

@NoaheCampbell NoaheCampbell merged commit cefc99d into main Jun 16, 2026
5 checks passed
@NoaheCampbell NoaheCampbell deleted the ep-version-picker-fallback-docs branch June 16, 2026 16:12
@AmberAlston

Copy link
Copy Markdown
Member

@NoaheCampbell this is good to merge when you're ready

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants