Skip to content

Adds minor docs clarification #133744

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 29, 2025
Merged

Adds minor docs clarification #133744

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5c90768
Adds minor docs clarification
yetanothertw Aug 28, 2025
4158a5d
Adding link to the differences page for reference
yetanothertw Aug 29, 2025
091c4fd
Merge branch 'main' into 2215-part-II
yetanothertw Aug 29, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions docs/reference/elasticsearch/security-privileges.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,7 @@ This section provides detailed **reference information** for Elasticsearch privi
Refer to [User roles](docs-content://deploy-manage/users-roles/cluster-or-deployment-auth/user-roles.md) in the **Deploy and manage** section for more information on how role-based access control works.


:::{note}
In {{serverless-full}}, Elastic manages the underlying infrastructure for you. Because of this, privileges related to cluster administration, scaling, snapshots, and availability are not available. Learn more about the [project custom roles managed by {{serverless-full}}](docs-content://deploy-manage/users-roles/serverless-custom-roles.md).
:::
In {{serverless-full}}, Elastic manages the underlying infrastructure for you. Because of this, privileges related to cluster administration, scaling, snapshots, and availability are not available. [Learn more about the features managed by {{serverless-full}}](docs-content://deploy-manage/users-roles/serverless-custom-roles.md).
Copy link
Contributor

Choose a reason for hiding this comment

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

sry I know this is so annoying

the link you're pointing to here and the meaning of this para are two different things. this link explains how to apply the roles (spiritually similar to the para above)

Suggested change
In {{serverless-full}}, Elastic manages the underlying infrastructure for you. Because of this, privileges related to cluster administration, scaling, snapshots, and availability are not available. [Learn more about the features managed by {{serverless-full}}](docs-content://deploy-manage/users-roles/serverless-custom-roles.md).
:::{note}
In {{serverless-full}}, Elastic manages the underlying infrastructure for you. Because of this, privileges related to cluster administration, scaling, snapshots, and availability are not available. [Learn more about the features managed by {{serverless-full}}](docs-content:///deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md).
:::

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I misunderstood, sorry about that. I hadn't realised that you meant to add a link to this particular page (in addition to the link for Serverless roles). I thought you only included the link as a reference to see how we talk about Serverless vs other deployments.

It's only annoying when I can't make sense of it, but once I understand it, I can see how everything falls into place and the docs are better for it.


Roles are governed by a set of configurable privileges grouped into these categories:

Expand Down
Loading