Add documentation for query rules retriever (#115696)

* Add initial query rules retriever docs

* Add docs tests

* Apply suggestions from code review

Co-authored-by: Liam Thompson <[email protected]>

* PR feedback

* Make query rules guide retriever-first

* Add warning to DSL doc

* Update docs/reference/search/retriever.asciidoc

Co-authored-by: Mike Pellegrini <[email protected]>

* Update docs/reference/search/retriever.asciidoc

Co-authored-by: Mike Pellegrini <[email protected]>

* Apply suggestions from code review

Co-authored-by: Mike Pellegrini <[email protected]>

* Give parameters subheading an explicit id

* Fix formatting

---------

Co-authored-by: Elastic Machine <[email protected]>
Co-authored-by: Liam Thompson <[email protected]>
Co-authored-by: Mike Pellegrini <[email protected]>
(cherry picked from commit 14a7b8f)

Author: 4 people

docs/reference/query-dsl/rule-query.asciidoc

@@ -12,6 +12,12 @@
 The old syntax using `rule_query` and `ruleset_id` is deprecated and will be removed in a future release, so it is strongly advised to migrate existing rule queries to the new API structure.
 ====
 
+[TIP]
+====
+The rule query is not supported for use alongside reranking.
+If you want to use query rules in conjunction with reranking, use the <<rule-retriever, rule retriever>> instead.
+====
+
 Applies <<query-rules-apis,query rules>> to the query before returning results.
 Query rules can be used to promote documents in the manner of a <<query-dsl-pinned-query>> based on matching defined rules, or to identify specific documents to exclude from a contextual result set.
 If no matching query rules are defined, the "organic" matches for the query are returned.