Skip to content

docs: port BYOC Azure self-onboarding changes from upstream#190

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3e599880
Open

docs: port BYOC Azure self-onboarding changes from upstream#190
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3e599880

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Ports the changes from clickhouse-docs PR #6371 (BYOC: fold Azure into standard onboarding & make BYO-VPC self-service) into the Mintlify docs.

Changes

  • Updated BYOC architecture, standard onboarding, customization (AWS/GCP), new-region, and network-security pages to include Azure subscription / VNet / AKS / service principal terminology.
  • Removed the standalone "Azure Private Preview" page (products/bring-your-own-cloud/onboarding/azure-private-preview.mdx) and its entry from the BYOC navigation and the cloud guides index.
  • GCP customized setup now documents self-service BYO-VPC infrastructure setup via the console instead of the previous "contact support" flow; added new screenshot byoc-gcp-existing-vpc-ui.png.
  • Updated/refreshed BYOC console screenshots (byoc-aws-existing-vpc-ui, byoc-new-infra-1/2, byoc-onboarding-1/2/3).
  • Minor wording, list-marker, and emphasis style alignments to match upstream.

Context

Notes / Ambiguities

  • The upstream change to _category_.json ("Customized Setup""Customized setup") has no direct Mintlify equivalent — the Mintlify nav already uses "Customization" as the group label, so no nav change was applied for that.
  • i18n translation directories were intentionally not updated (per instructions).
  • mint validate and mint broken-links were attempted but timed out in this environment, so they did not run to completion.

Note

Low Risk
Documentation-only updates to BYOC onboarding and navigation; no application or security logic changes.

Overview
Folds Azure BYOC into the standard onboarding story and drops the separate Azure Private Preview page, plus its BYOC nav and cloud guides index entries.

Standard onboarding, architecture, and additional infrastructure docs now describe Azure alongside AWS/GCP (subscription/VNet/AKS, Terraform module, shared terminology). GCP customized (BYO-VPC) setup is rewritten from a support-ticket flow to self-service console provisioning, matching AWS (new GCP UI screenshot). AWS BYO-VPC and network security get minor console-label and formatting alignments with upstream.

Reviewed by Cursor Bugbot for commit 6aadc04. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview Jun 12, 2026, 10:20 AM

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants