[Security Solution] Improve D&R API reference documentation

[banderror]

Related to: https://github.com/elastic/security-team/issues/9400

Summary

Improve the auto-generated API reference documentation available on elastic.co/docs/api for the following Serverless and Stateful APIs:

• Detections API
• Lists API
• Exceptions API
• Endpoint Exceptions API

We need to make these API docs more user-friendly and usable. For that, we need to improve and polish the corresponding OpenAPI specs: enrich them with summaries, descriptions, examples of usage, etc:

• Add summaries for whole API endpoints and specific HTTP methods.
• Add descriptions for API endpoints, HTTP methods, endpoint parameters, requests and responses, as well as schemas shared between multiple endpoints.
• Add examples of usage of each API endpoint.
• Make sure the API docs look nice on bump.sh.

Implementation tasks

### Tasks
- [ ] https://github.com/elastic/kibana/issues/183702
- [ ] https://github.com/elastic/kibana/issues/183822
- [ ] https://github.com/elastic/kibana/issues/183838
- [ ] https://github.com/elastic/kibana/issues/183841

[elasticmachine]

Pinging @elastic/security-detection-engine (Team:Detection Engine)

[elasticmachine]

Pinging @elastic/security-detections-response (Team:Detections and Resp)

[elasticmachine]

Pinging @elastic/security-solution (Team: SecuritySolution)

[elasticmachine]

Pinging @elastic/security-detection-rule-management (Team:Detection Rule Management)