Build that java api docs from a test (#24354)

We've had `QueryDSLDocumentationTests` for a while but it had a very
hopeful comment at the top about how we want to make sure that the
example in the query-dsl docs match up with the test but we never
had anything that made *sure* that they did. This changes that!

Now the examples from the query-dsl docs are all built from the
`QueryDSLDocumentationTests`. All except for the percolator example
because that is hard to do as it stands now.

To make this easier this change moves `QueryDSLDocumentationTests`
from core and into the high level rest client. This is useful for
two reasons:
1. We expect the high level rest client to be able to use the builders.
2. The code that builds that docs doesn't check out all of
Elasticsearch. It only checks out certain directories. Since we're
already including snippets from that directory we don't have to
make any changes to that process.

Closes #24320

Author: nik9000

client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/QueryDSLDocumentationTests.java

@@ -19,6 +19,8 @@ Note that you can easily print (aka debug) JSON generated queries using
 The `QueryBuilder` can then be used with any API that accepts a query,
 such as `count` and `search`.
 
+:query-dsl-test: {docdir}/../../client/rest-high-level/src/test/java/org/elasticsearch/client/documentation/QueryDSLDocumentationTests.java
+
 include::query-dsl/match-all-query.asciidoc[]
 
 include::query-dsl/full-text-queries.asciidoc[]
@@ -35,4 +37,4 @@ include::query-dsl/special-queries.asciidoc[]
 
 include::query-dsl/span-queries.asciidoc[]
 
-
+:query-dsl-test!:

core/src/test/java/org/elasticsearch/index/query/QueryDSLDocumentationTests.java

@@ -3,17 +3,11 @@
 
 See {ref}/query-dsl-bool-query.html[Bool Query]
 
-[source,java]
+["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
-QueryBuilder qb = boolQuery()
-    .must(termQuery("content", "test1"))    <1>
-    .must(termQuery("content", "test4"))    <1>
-    .mustNot(termQuery("content", "test2")) <2>
-    .should(termQuery("content", "test3"))  <3>
-    .filter(termQuery("content", "test5")); <4>
+include-tagged::{query-dsl-test}[bool]
 --------------------------------------------------
 <1> must query
 <2> must not query
 <3> should query
 <4> a query that must appear in the matching documents but doesn't contribute to scoring.
-

docs/java-api/query-dsl.asciidoc

@@ -3,14 +3,10 @@
 
 See {ref}/query-dsl-boosting-query.html[Boosting Query]
 
-[source,java]
+["source","java",subs="attributes,callouts,macros"]
 --------------------------------------------------
-QueryBuilder qb = boostingQuery(
-        termQuery("name","kimchy"),    <1> 
-        termQuery("name","dadoonet"))  <2>
-    .negativeBoost(0.2f);              <3>
+include-tagged::{query-dsl-test}[boosting]
 --------------------------------------------------
 <1> query that will promote documents
 <2> query that will demote documents
 <3> negative boost
-