Description
Was the documentation helpful?
No
What documentation page is affected
https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-snapshot-delete
Description
The old Elasticsearch and Kibana REST API documentation included a section for each API named "Prerequisites", which gave information about the Elasticsearch/Kibana security privilege which is required to execute the API. This information is valuable to understand what privilege is necessary to successfully call the API. For some APIs (e.g. new index, delete docs, etc.) its obvious what the relationship is between the API and the underlying privilege. But for other APIs (see example below), its not immediately obvious, so having the information within the API docs is extremely helpful and saves time.
For example, deleting a snapshot in a snapshot repository:
- Old docs - Delete snapshot API
- New docs - Delete snapshots (no information about the privilege required to call the API)
