<p dir="auto"><strong>Describe the feature</strong>:</p>
<p dir="auto">it would be great if the API documentation (the stuff on the web) had a "newbie" mode that would show query components within the context of a complete query.  for example, on <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-common-terms-query.html" rel="nofollow">https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-common-terms-query.html</a>, there are examples of the "common" block, but it's not clear (to me at least) where the "common" block fits in the query.</p>
<p dir="auto">I realize that adding that information to every page would be noisy for experienced users, so I'd suggest a way for newbies to say "show me this in the context of the ENTIRE query".  That would also be helpful as a learning tool, because by seeing lots of different examples, the newbie learns the structure of queries by osmosis.</p>
<p dir="auto"><strong>Describe the feature</strong>:<br>
<a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="152001521" data-permission-text="Title is private" data-url="https://github.com/elastic/elasticsearch/issues/18075" data-hovercard-type="pull_request" data-hovercard-url="/elastic/elasticsearch/pull/18075/hovercard" href="https://github.com/elastic/elasticsearch/pull/18075">#18075</a> will merge soon, testing all the <code class="notranslate">// CONSOLE</code> snippets in our docs. But lots of our docs <em>aren't</em> annotated with it! We should annotate more snippets so we test more of the docs.</p>
<p dir="auto">Edit: <code class="notranslate">// CONSOLE</code> has replaced <code class="notranslate">// AUTOSENSE</code>. The sense application is named console in 5.0.0.</p>