Skip to content

Conversation

charlotte-hoblik
Copy link
Contributor

@charlotte-hoblik charlotte-hoblik commented Aug 4, 2025

This PR updates the CCS compatibility table to improve clarity, maintainability, and reusability across the documentation.

Summary of changes

  • Expanded the table to list compatibility for each individual Elasticsearch version instead of merging adjacent version ranges. This addresses confusion around edge cases and exact version compatibility.

  • Removed an incorrect example that claimed a local 9.0 cluster can search a remote 8.19 cluster.

  • Moved the compatibility matrix into its own snippet (just the table, without notes or extra details) so it can be reused in multiple places, including the Solution section.

  • Removed the compatibility table from solution/search/cross-cluster-search.md to avoid duplication. (refers to the new snippet instead)

  • Added usage notes at the top of both updated snippets to document where they are reused.

Advantages of these changes

  • There is now only one compatibility table to maintain across the documentation.

  • Resolves the original issue where the table was misleading for some users.

  • Improves reusability by allowing the table to be embedded wherever needed.

Things to note

  • The original “small” table in the Deploy and manage section was more compact and included versions 5.0 to 9.0.

  • The new table is larger and only covers 7.17 to 9.1.

Connected to #1490

@charlotte-hoblik charlotte-hoblik self-assigned this Aug 4, 2025
@charlotte-hoblik charlotte-hoblik added the documentation Improvements or additions to documentation label Aug 4, 2025
Copy link

github-actions bot commented Aug 4, 2025

🔍 Preview links for changed docs

Copy link
Contributor

@florent-leborgne florent-leborgne left a comment

Choose a reason for hiding this comment

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

Awesome 👏 Good to unify these

@charlotte-hoblik charlotte-hoblik marked this pull request as ready for review August 14, 2025 10:29
@charlotte-hoblik charlotte-hoblik requested review from a team as code owners August 14, 2025 10:29
Copy link
Contributor

@szabosteve szabosteve left a comment

Choose a reason for hiding this comment

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

Awesome, LGTM!

Copy link
Contributor

@leemthompo leemthompo left a comment

Choose a reason for hiding this comment

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

Thanks!

An idea for our future selves, replace those silly huge icon markups and replace with simple emojis 😃. Editing that markup is inhumane.

| Local cluster version | 7.17 | 8.0 | 8.1 | 8.2 | 8.3 | 8.4 | 8.5 | 8.6 | 8.7 | 8.8 | 8.9 | 8.10 | 8.11 | 8.12 | 8.13 | 8.14 | 8.15 | 8.16 | 8.17 | 8.18 | 8.19 | 9.0 | 9.1 |
| 7.17 ||||||||||||||||||||||||
| 8.0 ||||||||||||||||||||||||
| 8.1 ||||||||||||||||||||||||
| 8.2 ||||||||||||||||||||||||
| 8.3 ||||||||||||||||||||||||
| 8.4 ||||||||||||||||||||||||
| 8.5 ||||||||||||||||||||||||
| 8.6 ||||||||||||||||||||||||
| 8.7 ||||||||||||||||||||||||
| 8.8 ||||||||||||||||||||||||
| 8.9 ||||||||||||||||||||||||
| 8.10 ||||||||||||||||||||||||
| 8.11 ||||||||||||||||||||||||
| 8.12 ||||||||||||||||||||||||
| 8.13 ||||||||||||||||||||||||
| 8.14 ||||||||||||||||||||||||
| 8.15 ||||||||||||||||||||||||
| 8.16 ||||||||||||||||||||||||
| 8.17 ||||||||||||||||||||||||
| 8.18 ||||||||||||||||||||||||
| 8.19 ||||||||||||||||||||||||
| 9.0 ||||||||||||||||||||||||
| 9.1 ||||||||||||||||||||||||

Also @florent-leborgne for our consideration re. rehoming content, the solutions/search version of this page probably needs to live in the Elasticsearch reference eventually I'm thinking.

Copy link
Contributor

@yetanothertw yetanothertw left a comment

Choose a reason for hiding this comment

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

Approved! Just left a question for you to consider, in case you want to make use of some of the version variables where possible.

P.S. 😵 My eyes hurt from looking this table!

@charlotte-hoblik charlotte-hoblik merged commit 111f424 into main Aug 14, 2025
7 checks passed
@charlotte-hoblik charlotte-hoblik deleted the charlotte-ccs-matrix-update-2 branch August 14, 2025 11:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants