Fix #28: Improved "Building Deliverables" with examples (#81)

* fix#28:improved building deliverables with examples

Signed-off-by: sushant-suse <[email protected]>

* fix#28:added changelog file

Signed-off-by: sushant-suse <[email protected]>

---------

Signed-off-by: sushant-suse <[email protected]>

Author: sushant-suse

changelog.d/81.doc.rst

@@ -0,0 +1 @@
+Add new examples to improves the documentation for the docbuild build command.

docs/source/user/build.rst

@@ -37,10 +37,13 @@ The fields in the doctype have the following meanings:
 
 Some common examples of doctypes are:
 
-* ``//en-us``: Matches all supported deliverables in English.
-* ``sles/*/en-us``: Matches all SLES deliverables in English, regardless of the docset or lifecycle.
+* ``sles/15-SP6/en-us``: Matches the English deliverables for SLES 15-SP6, regardless of the lifecycle.
+* ``*/*/de-de``: Matches all deliverables in German, regardless of the product, docset, or lifecycle.
+* ``//en-us``: Matches all deliverables in English, regardless of product, docset, or lifecycle. This is a shorter version of ``*/*/en-us``.
+* ``sles//en-us``: Matches all English SLES deliverables, regardless of the docset or lifecycle.
 * ``sle-ha//@unsupported/en-us,de-de``: Matches all SLE-HA deliverables in English and German that are in the unsupported lifecycle, regardless of the docset.
-* ``"*/@beta,supported/de-de"``: Matches all SLES deliverables in German that are in the beta or supported lifecycle, regardless of the product.
+* ``*/@beta,supported/de-de``: Matches all SLES deliverables in German that are in the beta or supported lifecycle, regardless of the product.
+* ``//``: Matches all deliverables in all languages, regardless of the product, docset, or lifecycle. This is the simplest doctype and matches everything.
 
 
 Minimal set of doctypes
@@ -54,4 +57,4 @@ The command tries to find overlaps in the specified doctypes and only builds the
 
    [1] sles/*/en-us + sles/15-SP6/en-us      => sles/*/en-us
    [2] sles/*/en-us + sles/15-SP6/de-de      => sles/*/en-us,sles/15-SP6/de-de
-   [3] sles/15-SP6/en-us + sles/15-SP6/de-de => sles/15-SP6/en-us,de-de
+   [3] sles/15-SP6/en-us + sles/15-SP6/de-de => sles/15-SP6/en-us,de-de