Skip to content

docs(doc-1573): clarify platform database, move to air-gapped section, split troubleshoot#2332

Merged
djwfyi merged 4 commits into
mainfrom
DOC-1573/platform-database
Jun 25, 2026
Merged

docs(doc-1573): clarify platform database, move to air-gapped section, split troubleshoot#2332
djwfyi merged 4 commits into
mainfrom
DOC-1573/platform-database

Conversation

@djwfyi

@djwfyi djwfyi commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

Content Description

Rewrites the platform database page to clarify it is an air-gapped-only feature for license billing snapshots. Splits the original maintenance page into a conceptual/configure page under Install > Air-Gapped and a dedicated troubleshoot page, with reciprocal links to the external database page and Netlify redirects for all moved paths.

Preview Link

Internal Reference

Closes DOC-1573

AI review: mention @claude in a comment to request a review or changes. See CONTRIBUTING.md for available commands.

FORK LIMITATION: @claude does not work on pull requests opened from forks. GitHub Actions cannot access the required secrets for fork-originated PRs. To use AI review, push your branch directly to this repository.

@netlify /docs

djwfyi and others added 2 commits June 25, 2026 09:24
… section, split troubleshoot

- Replace minimal maintenance stub with a full explanation of what the
  platform database is, when it is provisioned, what usage snapshots
  record, and how the database surfaces to administrators
- Move conceptual and configure content to platform/install/air-gapped/
  where it belongs (the database only exists in air-gapped environments)
- Create platform/troubleshoot/platform-database.mdx for the three
  troubleshoot scenarios: postgres pod failures, log errors, and PVC
  recovery
- Add reciprocal disambiguation note to external-database.mdx
- Update netlify.toml with redirects from both old paths
- Update vcluster/production-guide/overview.mdx link

Closes DOC-1573

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@djwfyi djwfyi requested a review from a team as a code owner June 25, 2026 14:00
@netlify

netlify Bot commented Jun 25, 2026

Copy link
Copy Markdown

Deploy Preview for vcluster-docs-site ready!

Name Link
🔨 Latest commit 6ef4ea4
🔍 Latest deploy log https://app.netlify.com/projects/vcluster-docs-site/deploys/6a3d46d32a4dff00084dbfef
😎 Deploy Preview https://deploy-preview-2332--vcluster-docs-site.netlify.app/docs
📱 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.

@djwfyi djwfyi self-assigned this Jun 25, 2026
@github-actions

Copy link
Copy Markdown
Contributor

The new platform-database page does not yet exist in the 4.10.0 stable
versioned docs, so the absolute link to install/air-gapped/platform-database
fails Docusaurus build-time validation. Point back to the maintenance path
(which exists in version-4.10.0) and let the Netlify redirect handle routing
to the new page at runtime.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@DadaGore

Copy link
Copy Markdown
Contributor

LGTM

…vron

Add pointer-events: none to the badge pseudo-element so it never blocks
clicks on the caret button behind it. Extend the offset rule to also
match .menu__link--sublist, which Docusaurus reliably adds to collapsible
category links, covering cases where .menu__caret alone does not match.

Affects: platform/install/air-gapped (pro) and five free-tier categories
in platform/use-platform and platform/administer.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@djwfyi djwfyi merged commit 3a514c0 into main Jun 25, 2026
12 checks passed
@djwfyi djwfyi deleted the DOC-1573/platform-database branch June 25, 2026 15:31
djwfyi added a commit that referenced this pull request Jun 25, 2026
…ed section, split troubleshoot (#2332) (#2333)

* Backport: Copy platform/administer/clusters/advanced/external-database/external-database.mdx to platform_versioned_docs/version-4.10.0/administer/clusters/advanced/external-database/external-database.mdx

* Backport: Copy platform/install/air-gapped/platform-database.mdx to platform_versioned_docs/version-4.10.0/install/air-gapped/platform-database.mdx

* Backport: Delete platform_versioned_docs/version-4.10.0/maintenance/platform-database/_category_.json (removed in source)

* Backport: Delete platform_versioned_docs/version-4.10.0/maintenance/platform-database/database.mdx (removed in source)

* Backport: Copy platform/troubleshoot/platform-database.mdx to platform_versioned_docs/version-4.10.0/troubleshoot/platform-database.mdx

* fix(doc-1573): update vcluster overview links to new platform-database path

The maintenance/platform-database page was removed by the backport. Point
all three vcluster overview versions (next, 0.35.0, 0.34.0) to the new
install/air-gapped/platform-database path.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Daryl White <daryl.white@loft.sh>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants