Skip to content

docs(platform): revise platform communication and connectivity page#2343

Open
djwfyi wants to merge 1 commit into
mainfrom
DOC-1505/platform-communication
Open

docs(platform): revise platform communication and connectivity page#2343
djwfyi wants to merge 1 commit into
mainfrom
DOC-1505/platform-communication

Conversation

@djwfyi

@djwfyi djwfyi commented Jun 29, 2026

Copy link
Copy Markdown
Collaborator

Content Description

Full rewrite of platform/understand/platform_communication.mdx (DOC-1505, DOC-1580). The previous page was a stub with VPN tunnel framing and a <!-- vale off --> suppression. This revision documents the egress-only agent model, agent vs proxy paths, Tailscale/DERP network path, required outbound ports, air-gapped behavior, and troubleshooting steps, verified against upstream source code.

Preview Link

https://deploy-preview-2343--vcluster-docs-site.netlify.app/docs/platform/next/understand/platform_communication

Internal Reference

Closes DOC-1505
Closes DOC-1580

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

Full rewrite of platform/understand/platform_communication.mdx for
DOC-1505 and DOC-1580. Replaces the old stub (VPN tunnel framing,
vale off suppression) with accurate, structured content covering the
egress-only agent model, agent vs proxy paths, Tailscale/DERP network
path, required outbound ports, air-gapped environments, and a
troubleshooting section.

Accuracy fixes verified against upstream source (loft-enterprise,
vcluster-pro): corrected port 10443 attribution, added the tenant
cluster control plane pod TSNet connection as a note, and confirmed
LOFT_USE_TAILSCALE_DERP and /derp/probe path details.

Also applies style and flow improvements to how-platform-works.mdx
(contractions, dangling modifier in regional endpoints paragraph).
Adds DERP and TSNet to the Vale vocabulary accept list.

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

netlify Bot commented Jun 29, 2026

Copy link
Copy Markdown

Deploy Preview for vcluster-docs-site ready!

Name Link
🔨 Latest commit 0d3cef0
🔍 Latest deploy log https://app.netlify.com/projects/vcluster-docs-site/deploys/6a42dc51ceacdc000779114c
😎 Deploy Preview https://deploy-preview-2343--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 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

Copy link
Copy Markdown
Contributor

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.

1 participant