[Docs] Update Query Roles API documentation

[slobodanadamovic]

The query role API now returns built-in roles as well.
This PR notes this and adds an example on how the built-in roles can be filtered out.

[github-actions]

Documentation preview:

• ✨ Changed pages

[elasticsearchmachine]

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

[elasticsearchmachine]

Pinging @elastic/es-security (Team:Security)

[lcawl]

Hi! This is a drive-by comment to make sure folks are aware that these API docs will not be carried forward to V9, so if the changes in this PR are applicable to that version, please ensure they occur in the following location:
https://github.com/elastic/elasticsearch-specification/tree/main/specification/security/query_role

That's how we'll be generating API documentation going forward (e.g. https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-query-role).

NOTE that since the rest of the documentation will also be undergoing a big migration, just a reminder not to hard-code any links when you're adding content to the specifications. For example, if you want to link to https://www.elastic.co/guide/en/elasticsearch/reference/current/built-in-roles.html I'd recommend using @ext_doc_id so it doesn't break (per https://github.com/elastic/elasticsearch-specification/blob/main/docs/modeling-guide.md#ext_doc_id).

If you want more info, please reach out on #docs!

[slobodanadamovic]

@lcawl Thanks for the heads up! I'll open a PR in https://github.com/elastic/elasticsearch-specification since this documentation change is also relevant for v9.

[leemthompo]

@slobodanadamovic can you get this approved and merged by tomorrow? Otherwise, you'll need to wait until February 20 to work on this after the docs freeze.

[slobodanadamovic]

@slobodanadamovic can you get this approved and merged by tomorrow? Otherwise, you'll need to wait until February 20 to work on this after the docs freeze.

Thanks for the info! Does this freeze also apply for docs update in https://github.com/elastic/elasticsearch-specification?

[n1v0lg]

Nit: not sure if we want to mention an ES version here. Wouldn't current docs be >=8.18 already?

[slobodanadamovic]

Good point! I'll remove it.

[leemthompo]

@slobodanadamovic can you get this approved and merged by tomorrow? Otherwise, you'll need to wait until February 20 to work on this after the docs freeze.
Thanks for the info! Does this freeze also apply for docs update in https://github.com/elastic/elasticsearch-specification?

I'm pretty sure it does not impact the spec, but @lcawl will keep me honest.

(I shared the email link in Slack for full comms info)

[elasticsearchmachine]

💚 Backport successful

Status	Branch	Result
✅	8.x