Skip to content

Clarify Stable IP change policy and DNS redirect language - #5056

Merged
Duncanma merged 5 commits into
mainfrom
stable-ips-change-policy
Aug 7, 2026
Merged

Clarify Stable IP change policy and DNS redirect language#5056
Duncanma merged 5 commits into
mainfrom
stable-ips-change-policy

Conversation

@lukeknep

@lukeknep lukeknep commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

What changed

1. Rewrote "Changes to Stable IP ranges"

The old text said Temporal "does not intend to make changes" and would give "ample time" — vague on both the commitment and the notice period. Replaced with the actual policy:

  • Once a region's Stable IP ranges are published, Temporal avoids adding new ranges, and has no plans to ever remove a published range.
  • If an unforeseen event forces an add or remove, Temporal gives six months of advance notice before the change takes effect, via targeted communication and the changelog.

2. Removed a stale DNS callout from the Stable IPs section

Removed the :::note Don't depend on DNS resolution behavior callout since it was out of place and factually stale. Its content already exists elsewhere:

  • docs/cloud/connectivity/ip-addresses.mdx — the "When Namespace Endpoint DNS resolution is predictable"
  • docs/cloud/get-started/namespaces.mdx — the "Do not take dependencies on Temporal Cloud endpoint DNS resolution" callout

3. "routes to" → "redirects via DNS to"

The Namespace Endpoint does not proxy or route traffic; it is a DNS redirect. Fixed the two places that implied otherwise:

  • architecture-patterns.mdx — "always routes to whichever region currently holds the active Namespace"
  • failovers/index.mdx — "re-routes to the active region" (and dropped the now-redundant "DNS" from the sentence after it)

🤖 Generated with Claude Code

┆Attachments: EDU-6906 Clarify Stable IP change policy and DNS redirect language

Rewrite "Changes to Stable IP ranges" to state the actual commitments:
once a region's ranges are published Temporal avoids adding to them and
has no plans to remove one, and any unforeseen add or remove comes with
six months of advance notice.

Remove the "Don't depend on DNS resolution behavior" callout from the
Stable IPs section. It named High Availability as the *only* case with
guaranteed DNS resolution, which is wrong now that Stable IPs is a second
case. The accurate version, listing both, already exists in "When
Namespace Endpoint DNS resolution is predictable" on the same page and in
the Namespaces page callout.

Replace "routes to" with "redirects via DNS to" where the docs describe
the Namespace Endpoint reaching an active region. The endpoint does not
proxy traffic; it is a DNS redirect.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@lukeknep
lukeknep requested a review from a team as a code owner August 6, 2026 23:05
@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 7, 2026 10:13pm

Request Review

@github-actions

github-actions Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Comment thread docs/cloud/connectivity/ip-addresses.mdx Outdated
Comment thread docs/cloud/connectivity/ip-addresses.mdx Outdated
Co-authored-by: Luke Knepper <lukeknepper@gmail.com>
Comment thread docs/cloud/connectivity/ip-addresses.mdx Outdated
@Duncanma
Duncanma enabled auto-merge (squash) August 7, 2026 22:11
@Duncanma
Duncanma merged commit c117f30 into main Aug 7, 2026
15 checks passed
@Duncanma
Duncanma deleted the stable-ips-change-policy branch August 7, 2026 22:13
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.

2 participants