Merge pull request #65977 from jeana-redhat/doc-guide-addl-resource-examples

[no issue] Update additional resources examples and guidelines

Author: kalexand-rh

contributing_to_docs/doc_guidelines.adoc

@@ -1710,28 +1710,28 @@ The following guidelines apply to all "Additional resources" sections:
 
 * You must include the `[role="_additional-resources"]` attribute declaration before the section heading.
 * You must not include paragraphs in the section. Use an unordered list.
-* The links and xrefs in the unordered list must contain human-readable text between the square brackets.
-* Each item in the unordered list must contain a minimum of text besides the link or xref.
+* The links and xrefs in the unordered list must contain minimal-length, human-readable text between the square brackets. This text is often the title of the linked page.
+* You must not include text outside of the square brackets.
 
 Additionally, in an assembly, use `==` formatting for the section heading (`== Additional resources`). Use of this heading syntax at the assembly level indicates that the sections relate to the whole assembly. For example:
 
 ----
 [role="_additional-resources"]
 [id="additional-resources_configuring-alert-notifications"]
 == Additional resources
-* link:some-url.com[Human readable label]
-* xref:some_xref[Human readable label]
-* xref:some_other_xref[Human readable label]
+* link:example.com[IANA example domain for documentation]
+* xref:../installation/installing-the-product.adoc#installing-the-product[Installing the product]
+* xref:../configuration/product-settings.adoc#installation-parameters_product-settings[Product installation configuration parameters]
 ----
 
 Only use `.` formatting (`.Additional resources`) in a module or to follow a module in an assembly. Because you cannot use the xrefs in modules, this functions as a _trailing include_ at the assembly level, where the `.` formatting of the `include` statement indicates that the resource applies specifically to the module and not to the assembly. For example:
 
 ----
 [role="_additional-resources"]
 .Additional resources
-* link:some-url.com[Human readable label]
-* xref:some_xref[Human readable label]
-* xref:some_other_xref[Human readable label]
+* link:example.com[IANA example domain for documentation]
+* xref:../installation/installing-the-product.adoc#installing-the-product[Installing the product]
+* xref:../configuration/product-settings.adoc#installation-parameters_product-settings[Product installation configuration parameters]
 ----
 
 == Admonitions