Skip to content

Conversation

@yetanothertw
Copy link
Contributor

@yetanothertw yetanothertw commented Aug 27, 2025

The applies_to tags are the preferred way to signal when a setting is unavailable or has been deprecated.

I've removed the verbose statements that referenced Serverless unavailability and replaced them with applies_to tags.

Fixes #2215

I've checked the privilege resolver and so far I can tell that:

  • manage_data_stream_global_retention and monitor_data_stream_global_retention have no effect (they're created with an empty set) -- I've kept the text that advises users they have no effect and have added an applies_to tag to show them as deprecated. (Not sure what other lifecycle to use)
  • manage_data_frame_transforms is deprecated and I think it provides some sort of backwards compatibility to use manage_transform instead. I've marked it as deprecated.
  • manage_slm -- it says it was deprecated in 8.15, but I can still see it maps to some ILM actions. The same with read_slm. I've added the deprecated tags.

From the index privilege file it seems that:

  • create, create_doc, index, and write, are also mapped to actions, so the mapping updates capabilities haven't been removed yet, although the Important admonitions state they will be removed. I can't find any deprecated index privileges, so I've not added any tags.

The apply_to tags are the preferred way to signal when a setting is unavailable or has been deprecated.

Fixes [elastic#2215](elastic/docs-content#2215)
@github-actions
Copy link
Contributor

github-actions bot commented Aug 27, 2025

🔍 Preview links for changed docs

@yetanothertw yetanothertw self-assigned this Aug 27, 2025
@yetanothertw yetanothertw added Team:Docs Meta label for docs team documentation docs-edit-applies-tags PRs that need edits to their docs applies_to tags for an upcoming release. and removed v9.2.0 docs-edit-applies-tags PRs that need edits to their docs applies_to tags for an upcoming release. labels Aug 27, 2025
@yetanothertw yetanothertw requested review from a team and shainaraskas August 27, 2025 16:08
@yetanothertw yetanothertw marked this pull request as ready for review August 27, 2025 16:08
@elasticsearchmachine elasticsearchmachine added needs:triage Requires assignment of a team area label and removed Team:Docs Meta label for docs team labels Aug 27, 2025
@yetanothertw yetanothertw added v9.2.0 >docs General docs changes labels Aug 27, 2025
@elasticsearchmachine elasticsearchmachine added the Team:Docs Meta label for docs team label Aug 27, 2025
@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/core-docs (Team:Docs)

@elasticsearchmachine elasticsearchmachine removed the needs:triage Requires assignment of a team area label label Aug 27, 2025
Copy link
Contributor

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

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

looks really good. might want to add a note similar to the one over here because there are so many serverless unavailable notes

@yetanothertw yetanothertw merged commit 0c2d8bb into elastic:main Aug 28, 2025
10 checks passed
yetanothertw added a commit to yetanothertw/elasticsearch that referenced this pull request Aug 28, 2025
Refers to elastic#133622 where a review comment was missed and updates the docs accordingly.
yetanothertw added a commit that referenced this pull request Aug 29, 2025
* Adds minor docs clarification

Refers to #133622 where a review comment was missed and updates the docs accordingly.

* Adding link to the differences page for reference
JeremyDahlgren pushed a commit to JeremyDahlgren/elasticsearch that referenced this pull request Aug 29, 2025
* Adds minor docs clarification

Refers to elastic#133622 where a review comment was missed and updates the docs accordingly.

* Adding link to the differences page for reference
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes documentation Team:Docs Meta label for docs team v9.2.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

refactor applies_to info in security-privileges.md

3 participants