Skip to content

docs(ep-v2): relabel the new Enterprise Portal from Alpha to Beta - #4401

Draft
Bishibop wants to merge 1 commit into
mainfrom
nick/sc-138827/ep-v2-relabel-beta
Draft

docs(ep-v2): relabel the new Enterprise Portal from Alpha to Beta#4401
Bishibop wants to merge 1 commit into
mainfrom
nick/sc-138827/ep-v2-relabel-beta

Conversation

@Bishibop

Copy link
Copy Markdown
Contributor

Docs half of the EP v2 Alpha -> Beta relabel. Story: https://app.shortcut.com/replicated/story/138827

sc-138828 (the EP v2 Beta entitlement flip) lists a merged relabeling PR as an explicit gate condition. The code half is replicatedhq/vandoor#10401. Follows the Security Center relabel, #4231.

What changed

The 16 page-level admonitions. Every enterprise-portal-v2-* page opens with the same :::note Alpha Feature block. Retitled to Beta Feature and rewritten two-tier, mirroring what #4231 did for Security Center — the availability claim goes only on the about page, the sub-pages get the shorter subject-to-change line.

Pages New text
about The new Enterprise Portal is Beta and is available to all vendors. Some capabilities might require additional access.
connect-repo, invite, vendor-api-automation The new Enterprise Portal is Beta. Features described on this page are subject to change. Some capabilities might require additional access.
the other twelve The new Enterprise Portal is Beta. Features described on this page are subject to change.

Two sentence-level decisions worth flagging:

  • "For access, contact your Replicated account representative" is deleted, not reworded, on the twelve pages that carried it. It describes the alpha access gate and is false at Beta. Relabel the Security Center from Alpha to Beta #4231 handled the same sentence the same way — access language gets removed when the gate goes away, not softened.
  • "Some capabilities might require additional access" is kept on the four pages that carried it instead, because it is still true: Terraform modules are premium-plan gated, and Security Center and Ask AI are separate toggles.

"the new Enterprise Portal" rather than "the Enterprise Portal", since the latter is ambiguous while Classic still exists.

The other three.

Location Change
sidebars.js:211 category label Enterprise Portal (New) (Alpha) -> (Beta)
security-center-enable-customer-access.mdx:46 ## Enterprise Portal (New) (Alpha) -> ## Enterprise Portal (New) (Beta) {#enterprise-portal-new}
custom-domains-using.md:76 "The New Enterprise Portal, which is in alpha, is the exception." -> "The New Enterprise Portal is the exception."

The Security Center heading gets a pinned anchor so its URL stops tracking the maturity word and does not move again at GA. It had exactly one inbound link, from enterprise-portal-v2-about.mdx, which 1112b899f removed last week — so nothing in the repo points at the old #enterprise-portal-new-alpha slug today. Explicit anchors are already the repo idiom ({#ec}, {#add-domain}, {#about-saml}).

custom-domains-using.md is the one place a maturity label leaked onto a page that has nothing to do with EP v2 — the direct analogue of the six such hits #4231 found, and the row most likely to be missed.

Not in scope

  • SAML markers. Already handled as GA rather than Beta by docs(ep): document SAML customer SSO as generally available #4389. SAML is enabled for all teams, so its stale Alpha resolves to no marker, not to "Beta". A blanket Alpha -> Beta sweep across EP v2 docs would have relabelled a GA feature as Beta.
  • "Preview". As a maturity label it does not appear anywhere in EP v2. Every hit is the portal-preview feature (replicated enterprise-portal preview), including the enterprise-portal-v2-access H1.
  • Two "alpha" mentions on enterprise-portal-v2-invite.mdx (lines 36 and 40) are release channel names in an example. Renaming them would make the docs wrong.
  • Channel Customizations (Alpha) on enterprise-portal-configure.mdx is EP v1 and genuinely still Alpha.
  • llms.txt lists only the six Classic pages and omits all 16 EP v2 pages. That is a coverage gap, not a maturity marker; it belongs to sc-139273.

Checks

  • Vale: 352 alerts before, 352 after across the 18 changed docs files. The single heading warning that moved is the same pre-existing sentence-case warning firing on the same heading; the pinned anchor is masked by TokenIgnores, as intended.
  • Repo-wide sweep after the change: zero remaining Alpha Feature, Enterprise Portal (New) (Alpha), or enterprise-portal-new-alpha.

Ordering

Overlaps #4391 (Portal Features / Ask AI) on sidebars.js and security-center-enable-customer-access.mdx, but on non-adjacent lines — 211 vs 217, and 46 vs 62. Either order merges cleanly. Marked draft; the intent is that it goes in with the sc-138828 flip rather than ahead of the Beta announcement.

sc-138828 (the EP v2 Beta entitlement flip) lists a merged relabeling PR as an
explicit gate condition. This is the docs half; the code half is a separate PR
in vandoor. Follows the Security Center relabel, #4231.

- All 16 enterprise-portal-v2-* pages open with the same ":::note Alpha
  Feature" block. Retitled to "Beta Feature" and rewritten two-tier the way
  #4231 did: the availability claim goes only on the about page, the sub-pages
  get the shorter subject-to-change line.
- "For access, contact your Replicated account representative" is deleted
  rather than reworded on the twelve pages that carried it. It describes the
  alpha access gate and is false at Beta, which is how #4231 handled the same
  sentence.
- "Some capabilities might require additional access" is kept on the four
  pages that carried it instead. It is still true: Terraform modules are
  premium-plan gated, and Security Center and Ask AI are separate toggles.
- Sidebar category label, the Security Center enable-access heading, and the
  stray "which is in alpha" aside on the Custom Domains page.

The Security Center heading gets a pinned {#enterprise-portal-new} anchor so
its URL stops tracking the maturity word and does not move again at GA. It had
one inbound link, which 1112b89 removed, so nothing in the repo points at
the old slug today.

Two "alpha" mentions remain on enterprise-portal-v2-invite.mdx. They are
release channel names in an example, not maturity labels.

Vale: 352 alerts before, 352 after. The one heading warning that moved is the
same pre-existing sentence-case warning on the same heading.
@netlify

netlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs ready!

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

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@netlify

netlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs-upgrade ready!

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

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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 Aug 21, 2026
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.

2 participants