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

Pinging @elastic/ml-core (Team:ML)

The top level docs tests run with security disabled, so the responses in the snippet testing won't contain an authorization object. Since we want everyone to run with security enabled we should include authorization in the docs and manipulate the response so the test passes.

Separately it's probably worth discussing whether the docs tests should be changed to run with security enabled. I think they should now that security is on by default. I don't know how much change that would cause to other test snippets in the docs - it might be masses of work or it might be as simple as deleting this one line:

I will discuss further with the Elasticsearch writers, but for now I've added substitution instructions to address the snippet failure.

@elasticmachine run elasticsearch-ci/docs