Skip to content

Refresh self-hosted Visibility support guidance#4281

Merged
lennessyy merged 7 commits intomainfrom
docs/visibility-support-matrix
Mar 13, 2026
Merged

Refresh self-hosted Visibility support guidance#4281
lennessyy merged 7 commits intomainfrom
docs/visibility-support-matrix

Conversation

@bechols
Copy link
Contributor

@bechols bechols commented Mar 12, 2026

Summary

Refresh the self-hosted Visibility page to reflect the current Visibility model and backend support story.

Changes

  • make advanced Visibility the default framing and move standard Visibility into a clearly marked legacy section
  • add a support matrix covering backend versions and Temporal Server version boundaries
  • include Elasticsearch and OpenSearch version guidance
  • update stale future-tense support language to reflect current Temporal Server v1.30.1 reality
  • clarify Cassandra and standard Visibility deprecation/removal status

Validation

  • yarn build

Why

The current page mixed current and legacy Visibility guidance and left the backend/version compatibility story ambiguous, especially for Cassandra, Elasticsearch, and OpenSearch.

┆Attachments: EDU-6037 Refresh self-hosted Visibility support guidance

@bechols bechols requested review from a team and tlotemporal as code owners March 12, 2026 16:14
@vercel
Copy link

vercel bot commented Mar 12, 2026

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Mar 13, 2026 0:23am

Request Review

@github-actions
Copy link
Contributor

github-actions bot commented Mar 12, 2026

📖 Docs PR preview links

@dustin-temporal
Copy link
Contributor

Seems like a good opportunity to lump in this task and just do away with Standard Visibility in the docs. What do you think @bechols ? #3581 (comment)

@bechols
Copy link
Contributor Author

bechols commented Mar 12, 2026

Seems like a good opportunity to lump in this task and just do away with Standard Visibility in the docs. What do you think @bechols ? #3581 (comment)

Certainly open to reducing the visibility (ha) of the legacy distinction. Does seem like we need to keep some reference, but it could be less prominent. What if I just move the legacy section to the bottom of the page? Also, if you know what this should look like, please take the branch and run with it.

Addresses #3581 - standard Visibility was deprecated in v1.21 and
removed in v1.24. This rewrites the conceptual Visibility page to
treat current Visibility as the default, moves standard Visibility
into a historical context callout, fixes ElasticSearch casing, and
adds OpenSearch to the supported backends list.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@dustin-temporal
Copy link
Contributor

resolves #3581

@dustin-temporal
Copy link
Contributor

Seems like a good opportunity to lump in this task and just do away with Standard Visibility in the docs. What do you think @bechols ? #3581 (comment)

Certainly open to reducing the visibility (ha) of the legacy distinction. Does seem like we need to keep some reference, but it could be less prominent. What if I just move the legacy section to the bottom of the page? Also, if you know what this should look like, please take the branch and run with it.

added some changes to accomplish this!

@bechols
Copy link
Contributor Author

bechols commented Mar 12, 2026

Thanks @dustin-temporal this is great!


## Legacy: standard Visibility {#standard-visibility}

:::info Historical context
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this could just be paragraph text instead of in an admonition


## Legacy: standard Visibility {#standard-visibility}

:::info Historical context
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:::info Historical context

@lennessyy lennessyy enabled auto-merge (squash) March 13, 2026 00:23
@lennessyy lennessyy merged commit 27a11e6 into main Mar 13, 2026
10 checks passed
@lennessyy lennessyy deleted the docs/visibility-support-matrix branch March 13, 2026 00:24
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.

3 participants