Skip to content

docs: rename infrastructure options to single-tenant / multi-tenant#10789

Merged
keydunov merged 12 commits intomasterfrom
docs/rename-infrastructure-options-tenancy
Apr 30, 2026
Merged

docs: rename infrastructure options to single-tenant / multi-tenant#10789
keydunov merged 12 commits intomasterfrom
docs/rename-infrastructure-options-tenancy

Conversation

@keydunov
Copy link
Copy Markdown
Member

Renames the customer-facing display text for the infrastructure options to use industry-standard single-tenant / multi-tenant terminology and removes the naming collision with the Shared / Dedicated deployment types.

  • "Shared infrastructure" -> "Multi-tenant infrastructure"
  • "Dedicated infrastructure" -> "Single-tenant infrastructure"
  • "Dedicated infrastructure with CSPS" -> "Single-tenant infrastructure with CSPS"

URL anchors (#shared-infrastructure, #dedicated-infrastructure, #dedicated-infrastructure-with-csps), reference link IDs, and product region identifier slugs (aws-us-east-1-shared, etc.) are intentionally left unchanged so external inbound links and product identifiers keep working. Mintlify explicit anchor syntax is used to preserve them under the renamed headings.

Also documents the new terminology in .cursor/rules/namings-rule.mdc.

Made-with: Cursor

Check List

  • Tests have been run in packages where changes have been made if available
  • Linter has been run for changed code
  • Tests for the changes have been added if not covered yet
  • Docs have been added / updated if required

Renames the customer-facing display text for the infrastructure options
to use industry-standard single-tenant / multi-tenant terminology and
removes the naming collision with the Shared / Dedicated deployment
types.

- "Shared infrastructure" -> "Multi-tenant infrastructure"
- "Dedicated infrastructure" -> "Single-tenant infrastructure"
- "Dedicated infrastructure with CSPS" -> "Single-tenant infrastructure with CSPS"

URL anchors (#shared-infrastructure, #dedicated-infrastructure,
#dedicated-infrastructure-with-csps), reference link IDs, and product
region identifier slugs (aws-us-east-1-shared, etc.) are intentionally
left unchanged so external inbound links and product identifiers keep
working. Mintlify explicit anchor syntax is used to preserve them under
the renamed headings.

Also documents the new terminology in .cursor/rules/namings-rule.mdc.

Made-with: Cursor
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 30, 2026

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

Project Status Preview Updated (UTC)
cubed3 🟢 Ready View Preview Apr 30, 2026, 8:49 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Apr 30, 2026

Claude finished @keydunov's task in 2m 12s —— View job


Review: docs rename infrastructure options to single-tenant / multi-tenant

  • Gather context and review all changed files
  • Check consistency of terminology renaming
  • Verify anchor preservation strategy
  • Review .cursor/rules addition
  • Post review feedback

Overall this is a clean, well-scoped terminology rename. The anchor preservation strategy using Mintlify's {#anchor} syntax is solid, and the .cursor/rules/namings-rule.mdc addition is thorough and will help maintain consistency going forward.

Missed Renaming — 6 Instances of Old Terminology

I found 6 remaining occurrences of "Dedicated Infrastructure" in customer-facing prose that were not updated. These are across 4 VPC-related files:

File Line Text
vpc/aws/private-link.mdx 8 "Cube Cloud Dedicated Infrastructure"
vpc/aws/private-link.mdx 38 "Dedicated Infrastructure Region:" (bold label)
vpc/aws/vpc-peering.mdx 25 "Dedicated Infrastructure Region:" (bold label)
vpc/azure/private-link.mdx 8 "Cube Cloud Dedicated Infrastructure"
vpc/azure/private-link.mdx 43 "Dedicated Infrastructure Region:" (bold label)
vpc/azure/vpc-peering.mdx 88 "Dedicated Infrastructure Region:" (bold label)

The link text inside these bullet points was correctly updated to "single-tenant infrastructure", but the surrounding prose and bold labels were missed. I've left inline suggestions on the 4 lines that are part of the diff. The two intro paragraphs (line 8 of each private-link file) are on unchanged lines — those should also be updated to say "Cube Cloud single-tenant infrastructure".

Fix these →

What Looks Good

  • Anchor preservation: The {#shared-infrastructure}, {#dedicated-infrastructure}, and {#dedicated-infrastructure-with-csps} explicit anchors on the renamed headings in infrastructure.mdx correctly preserve external URLs.
  • Reference link IDs unchanged: All [ref-dedicated-infra], [dedicated-infra], [dedicated-infrastructure] link definition IDs are left intact — no broken internal links.
  • Region slug documentation: The explanation in infrastructure.mdx lines 127-133 correctly notes that slug values like shared, dedicated, byoc are literal product identifiers, separate from the customer-facing terminology. This is clear and well done.
  • deployment-types.mdx line 73: The rephrasing from "on dedicated infrastructure" to "on compute dedicated to your deployment" is a nice touch — it avoids the naming collision the PR description calls out.
  • Naming rule: The .cursor/rules/namings-rule.mdc addition is comprehensive and will prevent drift in future edits.

No Other Issues Found

  • No security, performance, or testing concerns (docs-only change).
  • No broken links — all reference-style link definitions resolve correctly.
  • Navigation config (docs.json) uses file paths, not titles, so the VPC index page title change won't break the sidebar.

@@ -36,8 +36,8 @@ To request establishing a PrivateLink connection, please share the following inf
- **Ports**: a list of ports that will be accessed through this connection
- **DNS Name** (optional): an internal DNS name of the upstream service in case SSL needs to be supported
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted in
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.

The bold label still says "Dedicated Infrastructure Region" while the link text inside was updated. Should be consistent:

Suggested change
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted in
- **Single-tenant Infrastructure Region:** VPC Peering requires Cube to be hosted in

@@ -23,8 +23,8 @@ information is required:
- **AWS VPC CIDR:** The [CIDR block][wiki-cidr-block] of the VPC that Cube Cloud
will connect to, for example, `10.0.0.0/16`
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted in
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.

Same issue — the bold label still uses the old name:

Suggested change
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted in
- **Single-tenant Infrastructure Region:** VPC Peering requires Cube to be hosted in

@@ -41,8 +41,8 @@ To request establishing a Private Link connection, please share the following in
- **Ports**: a list of ports that will be accessed through this connection
- **DNS Name** (optional): an internal DNS name of the upstream service in case SSL needs to be supported
- **Dedicated Infrastructure Region:** Private Link requires Cube to be hosted in
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.

Bold label still uses old name:

Suggested change
- **Dedicated Infrastructure Region:** Private Link requires Cube to be hosted in
- **Single-tenant Infrastructure Region:** Private Link requires Cube to be hosted in

@@ -86,8 +86,8 @@ information:
→ **Properties** → **Tenant ID** section of
[Azure Portal][azure-console].
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted
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.

Bold label still uses old name:

Suggested change
- **Dedicated Infrastructure Region:** VPC Peering requires Cube to be hosted
- **Single-tenant Infrastructure Region:** VPC Peering requires Cube to be hosted

Matches the wording already used for Single-tenant infrastructure.

Made-with: Cursor
Enterprise is the top tier — there is nothing above it, so the phrase
"Enterprise and above plans" is meaningless. Replaces all 32 occurrences
across docs-mintlify with "Enterprise plan" (singular), and rewords the
single "Enterprise and above product tiers" reference in pricing.mdx.

Adds a new "Plan Tier Naming" section to .cursor/rules/namings-rule.mdc
to codify the convention so future docs avoid this pattern.

Made-with: Cursor
CSPS sits on top of single-tenant infrastructure, so it requires both
the Enterprise plan and the Single-tenant infrastructure add-on.

Made-with: Cursor
Plan availability is a hard gate, not a "by the way" aside. Switching
the callout from <Info> (blue, used heavily for general notes) to
<Note> (gray) makes plan-gating info visually distinct and scannable.

Converts all 47 plan-availability blocks across 42 files. The script at
/tmp/convert_info_to_note.py only swaps <Info> blocks whose inner content
starts with "Available", leaving non-plan Info blocks untouched.

Also adds a "Plan availability callouts" section to namings-rule.mdc to
codify the convention.

Made-with: Cursor
Use the user-facing terms directly. The URL examples below already show
the literal slugs (shared, byoc, etc.) in context.

Made-with: Cursor
… nav

Promotes the page to sit right after Deployment types so the deployment-
level concepts (types, environments) are grouped together before
infrastructure and operational topics. Updates both title and sidebarTitle
to "Deployment environments" so the term is unambiguous when referenced
out of context.

Made-with: Cursor
Groups the infrastructure-related pages together (Infrastructure options
followed by VPC and BYOC sub-groups), separating them from the
deployment-level operational topics that come before.

Made-with: Cursor
- Card hrefs were bare relative paths ("vpc/aws") that Mintlify resolved
  to /admin/deployment/vpc/vpc/aws — fixed to absolute paths.
- Combined the two-line plan-availability Info into a single Note
  matching the new convention (Enterprise plan + Single-tenant add-on).
- Removed an orphaned heading-without-hash line.
- Updated the legacy /docs/deployment/cloud/... reference link target
  to the current /admin/deployment/infrastructure path.

Made-with: Cursor
- Parent VPC index: card description and intro now distinguish AWS/GCP
  VPCs from Azure VNets.
- Azure VNet Peering page: sidebarTitle "VPC Peering" → "VNet Peering",
  and the inline "VPC Peering" reference in the support-info checklist.
- Azure Private Link: replaces a stale "Cube Cloud Dedicated
  Infrastructure" mention with the new "single-tenant infrastructure"
  term, matching the rest of the rename.
- Renames the support-info bullet "Dedicated Infrastructure Region" to
  "Single-tenant Infrastructure Region" on both Azure pages.
- Fixes AWS sidebarTitle typo "VCP Peering" → "VPC Peering".
- Updates 5 stale legacy reference links pointing to
  /docs/deployment/cloud/infrastructure → /admin/deployment/infrastructure.

Made-with: Cursor
Card components in index pages used bare relative paths that included
the parent directory name (e.g., on /admin/sso, href="sso/okta") which
Mintlify resolves relative to the current page, producing broken URLs
like /admin/sso/sso/okta. Switches all 51 affected hrefs to absolute
paths so they resolve correctly.

Files affected:
- admin/connect-to-data/visualization-tools/index.mdx (29 cards)
- admin/monitoring/monitoring-integrations/index.mdx (5)
- admin/deployment/{vpc,byoc,providers}/index.mdx (8)
- admin/sso/{index,microsoft-entra-id/index}.mdx (5)
- docs/integrations/semantic-layer-sync/index.mdx (3)
- reference/orchestration-api/index.mdx (3)
- docs/getting-started/index.mdx (1, plus retargeted to a real page)

Made-with: Cursor
@keydunov keydunov merged commit 3fb18a2 into master Apr 30, 2026
7 checks passed
@keydunov keydunov deleted the docs/rename-infrastructure-options-tenancy branch April 30, 2026 23:31
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.

1 participant