Skip to content

docs: explain why regions map to real places - #63

Open
kevwilliams wants to merge 4 commits into
mainfrom
docs/locations-why-regions-are-real-places
Open

kevwilliams wants to merge 4 commits into
mainfrom
docs/locations-why-regions-are-real-places

Conversation

@kevwilliams

Copy link
Copy Markdown
Contributor

Summary

  • Adds a plain-language "Why a region is a real place" section to the Locations page, aimed at customers rather than engineers.
  • Companion to a handbook trim in datum-cloud/datum.net that removes the duplicated region facts (naming convention, region list) from the handbook and FAQ, pointing both to this page as the single source of truth.

Test plan

  • Preview renders correctly in Mintlify
  • Links resolve (https://www.datum.net/locations/, internal anchors)
  • No duplicate/contradictory info vs. the region table further down the same page
  • Tone reads as customer-facing, not internal engineering rationale

Add a plain-language section to the Locations page answering why
Datum ties Regions and AZs to real cities instead of an abstract
global zone, so customers understand the latency, sovereignty, and
choice implications without needing engineering background.
@mintlify

mintlify Bot commented Sep 14, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
Datum 🟢 Ready View Preview Oct 30, 2026, 9:29 PM

The handbook's country-code rationale (avoiding continent vs. country
confusion, e.g. North America vs. US) was being dropped entirely once
the handbook trim in datum-cloud/datum.net#1727 lands. Fold a
customer-phrased version into the naming convention section here so
it isn't lost.
scotwells
scotwells previously approved these changes Oct 23, 2026
@dlotterman

Copy link
Copy Markdown
Contributor

I believe in this PR so much I commited a conflict resolution.

@ecv ecv closed this Nov 3, 2026
@ecv ecv reopened this Nov 3, 2026

This branch was successfully deployed

1 active deployment
staging — a9798040 Deployed Oct 30, 2026 by mintlify[bot]
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.

4 participants