Skip to content

Document KOTS/kURL support in the new Enterprise Portal - #4308

Merged
AmberAlston merged 4 commits into
mainfrom
amber/ep-v2-docs-update
Jul 28, 2026
Merged

Document KOTS/kURL support in the new Enterprise Portal#4308
AmberAlston merged 4 commits into
mainfrom
amber/ep-v2-docs-update

Conversation

@AmberAlston

@AmberAlston AmberAlston commented Jul 27, 2026

Copy link
Copy Markdown
Member

Preview links

Summary

Updates the new Enterprise Portal docs to reflect KOTS/kURL version-filtered downloads (shipped in vandoor #10267) and to reframe how the portal compares to both prior customer experiences (Classic Enterprise Portal and Download Portal).

Changes

enterprise-portal-v2-about.mdx

  • Corrected the stale limitation. The first "Current limitations" bullet claimed the portal provides nothing for KOTS/kURL. It now scopes the limitation to generated step-by-step instructions (still Helm/EC only) and notes that air gap KOTS/kURL customers can download versioned install and update artifacts.
  • Reworked "What's new". Previously implied a Classic-only comparison. Now names both prior experiences (Classic Enterprise Portal, Download Portal) and groups each item by which it's new against: new vs both, new for Classic customers (KOTS/kURL support), and new for Download Portal customers (accounts/teams, instance & update management, support bundle uploads).
  • Added KOTS/kURL to the "Download install artifacts" capability bullet.

enterprise-portal-v2-use.mdx

  • Rewrote the "KOTS and kURL instances" section. The old text said these cards don't expand — they now expand into a download panel. Describes the version picker, the artifacts, the install-type + air gap gating, and expired-license behavior. Cross-links the <InstancesAndUpdates /> component in the default content template.

enterprise-portal-v2-content.mdx

  • Added the missing isKurlInstallEnabled built-in entitlement flag.
  • Noted the KOTS/kURL download panel in the <InstancesAndUpdates /> component reference.

Notes for review

  • No "v1/v2" version framing in prose — kept Classic vs. new throughout.
  • "Security data" is deliberately not listed as new for Download Portal customers, since Security Center is Helm/EC only and that audience skews KOTS/kURL. The scope remains documented in Current limitations.
  • Step-by-step KOTS/kURL upgrade guidance is still out of scope (deferred); the docs reflect download-only today.

🤖 Generated with Claude Code

Reflect the KOTS/kURL version-filtered downloads shipped for EP v2
(vandoor #10267) and reframe the Classic vs. Download Portal comparison.

- about: correct the outdated "no KOTS/kURL" limitation to reflect that
  air gap KOTS/kURL customers can now download versioned install and
  update artifacts; note the remaining gap (no generated step-by-step
  instructions)
- about: restructure "What's new" to compare against both the Classic
  Enterprise Portal and the Download Portal, grouped by which prior
  experience each item is new against
- about: add KOTS/kURL to the artifact-download capability
- use: rewrite the KOTS/kURL instances section to describe the instance
  card download panel, its entitlement/air gap gating, and expired-license
  behavior; cross-link the default template's <InstancesAndUpdates />
- content: add the missing isKurlInstallEnabled built-in flag and note the
  KOTS/kURL download panel in the <InstancesAndUpdates /> component entry

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 27, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit c3f8307
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a68c7aec7b7270008f797f8
😎 Deploy Preview https://deploy-preview-4308--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 Jul 27, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit c3f8307
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a68c7aeadd5f9000857040a
😎 Deploy Preview https://deploy-preview-4308--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.

@github-actions github-actions Bot added type::docs Improvements or additions to documentation type::feature labels Jul 27, 2026
Comment thread docs/vendor/enterprise-portal-v2-about.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-content.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-use.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-use.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-use.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-use.mdx Outdated
Comment thread docs/vendor/enterprise-portal-v2-use.mdx Outdated
AmberAlston and others added 2 commits July 27, 2026 14:18
- about: split the "What's new" intro sentence (SentenceLength)
- use: split the KOTS/kURL download-panel sentence (SentenceLength,
  OxfordComma); "admin console" -> "Admin Console"; "is expired" ->
  "has expired" and active voice for the <InstancesAndUpdates /> sentence
- content: "via" -> "through" on the built-in flags line

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… intro

- Collapse the three What's new groups into two: everything new vs the
  Classic Enterprise Portal (rebuild items + KOTS/kURL support), then a
  subsection for what's additionally new vs the Download Portal
- Remove the redundant "Classic doesn't support / new does" framing from
  the KOTS and kURL customers section; keep the migration steps and the
  cross-link to the use page
- Minor active-voice / wording fixes to keep Vale clean on changed lines

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AmberAlston
AmberAlston marked this pull request as ready for review July 27, 2026 20:39
@AmberAlston
AmberAlston requested a review from a team as a code owner July 27, 2026 20:39
@AmberAlston
AmberAlston requested a review from Bishibop July 27, 2026 20:40
## Current limitations {#current-limitations}

- Installation and upgrade instructions are available only for Embedded Cluster and Helm CLI installations. The Enterprise Portal does not provide instructions for KOTS or kURL. For more information, see [KOTS and kURL customers](#kots-and-kurl-customers).
- The Enterprise Portal does not generate step-by-step install or upgrade instructions for KOTS or kURL installations. These are available only for Embedded Cluster and Helm CLI installations. KOTS and kURL customers with air gap enabled can instead download versioned install and update artifacts from the Instances & Updates page. For more information, see [KOTS and kURL customers](#kots-and-kurl-customers).

@Bishibop Bishibop Jul 28, 2026

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.

"from the Instances & Updates page", also the method specific installer pages. one for Kots and one for Kurl.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Good catch, thanks. Updated the limitation to say artifacts are available from the Instances & Updates page and from dedicated KOTS and kURL installer pages. Also documented the two components that render those pages (<KotsDownloadAssets /> / <KurlDownloadAssets />) in the MDX component reference and expanded the KOTS and kURL instances section. See c3f8307.

Bishibop
Bishibop previously approved these changes Jul 28, 2026
Addresses review feedback: versioned install/update artifacts are
downloadable both from the Instances & Updates page and from dedicated
KOTS and kURL installer pages (the <KotsDownloadAssets /> and
<KurlDownloadAssets /> components). Documents both components in the
MDX component reference and expands the KOTS and kURL instances section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AmberAlston
AmberAlston merged commit 11ab584 into main Jul 28, 2026
5 checks passed
@AmberAlston
AmberAlston deleted the amber/ep-v2-docs-update branch July 28, 2026 15:17
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