[solr] branch branch_9x updated: SOLR-14540: add an example clarifying the use case. (#499)

[ep...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

epugh pushed a commit to branch branch_9x
in repository https://gitbox.apache.org/repos/asf/solr.git


The following commit(s) were added to refs/heads/branch_9x by this push:
     new 199477e9345 SOLR-14540: add an example clarifying the use case. (#499)
199477e9345 is described below

commit 199477e934560389d5ff42e5436f0e4c038f8599
Author: Mikhail Khludnev <mk...@users.noreply.github.com>
AuthorDate: Fri Jan 13 19:40:15 2023 +0300

    SOLR-14540: add an example clarifying the use case. (#499)
    
    
    Co-authored-by: Eric Pugh <ep...@opensourceconnections.com>
---
 solr/solr-ref-guide/modules/query-guide/pages/json-query-dsl.adoc | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/solr/solr-ref-guide/modules/query-guide/pages/json-query-dsl.adoc b/solr/solr-ref-guide/modules/query-guide/pages/json-query-dsl.adoc
index 9ae5267227f..85544cbd5c7 100644
--- a/solr/solr-ref-guide/modules/query-guide/pages/json-query-dsl.adoc
+++ b/solr/solr-ref-guide/modules/query-guide/pages/json-query-dsl.adoc
@@ -449,8 +449,10 @@ Tags will not affect a query unless they are referenced by some other part of th
 == Faceting Nested Documents
 
 This paragraph binds many features together.
-Basically it's an example of filter exclusions for nested documents when facets are counted over child document  fields, but facet counts roll up in parent document counts.
-Let's go on item by item:
+Basically it's an example of filter exclusions for nested documents when facets are counted over child
+document fields, but facet counts roll up in parent document counts.  A typical scenario where you might
+need to do this is if you are displaying filters for products (parents) with SKUs with various colour/size
+options (children). Let's go on item by item:
 
 * _Filter exclusion_ is usually necessary when multiple filter values can be applied to each field.
 This is also also known as drill-sideways facets.