Fix role-related API spec (#3033)

There is a display glitch in the ES serverless API: see live [spec](https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-security-get-role).

where details of several APIs are rendered as API headers. This PR fixes the rendering issue by including the relevant header info in top-level comments for each affected API.

Author: n1v0lg

output/openapi/elasticsearch-openapi.json

@@ -21,6 +21,9 @@ import { RequestBase } from '@_types/Base'
 import { Name, Refresh } from '@_types/common'
 
 /**
+ * Delete roles API.
+ *
+ * Removes roles in the native realm.
  * @rest_spec_name security.delete_role
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

output/openapi/elasticsearch-serverless-openapi.json

@@ -20,6 +20,9 @@
 import { RequestBase } from '@_types/Base'
 
 /**
+ * Get builtin privileges API.
+ *
+ * Retrieves the list of cluster privileges and index privileges that are available in this version of Elasticsearch.
  * @rest_spec_name security.get_builtin_privileges
  * @availability stack since=7.3.0 stability=stable
  * @availability serverless stability=stable visibility=public

output/schema/schema-serverless.json

@@ -21,8 +21,9 @@ import { RequestBase } from '@_types/Base'
 import { Names } from '@_types/common'
 
 /**
- * The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
- * The get roles API cannot retrieve roles that are defined in roles files.
+ * Get roles API.
+ *
+ * Retrieves roles in the native realm.
  * @rest_spec_name security.get_role
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public

output/schema/schema.json

@@ -29,8 +29,9 @@ import { RequestBase } from '@_types/Base'
 import { Metadata, Name, Refresh } from '@_types/common'
 
 /**
- * The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
- * The create or update roles API cannot update roles that are defined in roles files.
+ * Create or update roles API.
+ *
+ * Create or update roles in the native realm.
  * @rest_spec_name security.put_role
  * @availability stack stability=stable
  * @availability serverless stability=stable visibility=public