issue-126 reinstated old Additional resources examples

Author: emmurphy1

modular-docs-manual/files/TEMPLATE_ASSEMBLY_a-collection-of-modules.adoc

@@ -38,10 +38,10 @@ include::modules/TEMPLATE_PROCEDURE_reference-material.adoc[leveloffset=2]
 
 [role="_additional-resources"]
 == Additional resources (or Next steps)
-// An optional bulleted list of links to other material closely related to the contents of the assembly.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the assembly, including xref links to other assemblies in your collection.
+* For more details on writing assemblies, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
 
 // Restore the context to what it was before this assembly.
 ifdef::parent-context[:context: {parent-context}]

modular-docs-manual/files/TEMPLATE_CONCEPT_concept-explanation.adoc

@@ -26,7 +26,8 @@ The contents of a concept module give the user descriptions and explanations nee
 
 [role="_additional-resources"]
 .Additional resources
-// An optional bulleted list of links to other material closely related to the contents of the concept module.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the concept module.
+* Currently, modules cannot include xrefs, so you cannot include links to other content in your collection. If you need to link to another assembly, add the xref to the assembly that includes this module.
+* For more details on writing concept modules, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].

modular-docs-manual/files/TEMPLATE_PROCEDURE_doing-one-procedure.adoc

@@ -43,7 +43,8 @@ The `[role="_abstract"]` tag defines the first paragraph of the module for searc
 
 [role="_additional-resources"]
 .Additional resources
-// An optional bulleted list of links to other material closely related to the contents of the procedure module.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the procedure module.
+* Currently, modules cannot include xrefs, so you cannot include links to other content in your collection. If you need to link to another assembly, add the xref to the assembly that includes this module.
+* For more details on writing procedure modules, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].

modular-docs-manual/files/templates-without-comments/assembly-a-collection-of-modules.adoc

@@ -21,10 +21,11 @@ include::modules/TEMPLATE_PROCEDURE_doing_one_procedure.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
 == Additional resources (or Next steps)
-// An optional bulleted list of links to other material closely related to the contents of the assembly.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the assembly, including xref links to other assemblies in your collection.
+* For more details on writing assemblies, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
 
+// Restore the context to what it was before this assembly.
 ifdef::parent-context[:context: {parent-context}]
 ifndef::parent-context[:!context:]

modular-docs-manual/files/templates-without-comments/con-concept-explanation.adoc

@@ -15,7 +15,8 @@ The contents of a concept module give the user descriptions and explanations nee
 
 [role="_additional-resources"]
 .Additional resources
-// An optional bulleted list of links to other material closely related to the contents of the concept module.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the concept module.
+* Currently, modules cannot include xrefs, so you cannot include links to other content in your collection. If you need to link to another assembly, add the xref to the assembly that includes this module.
+* For more details on writing concept modules, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].

modular-docs-manual/files/templates-without-comments/proc-doing-one-procedure.adoc

@@ -32,7 +32,8 @@ The `[role="_abstract"]` tag defines the first paragraph of the module for searc
 
 [role="_additional-resources"]
 .Additional resources
-// An optional bulleted list of links to other material closely related to the contents of the procedure module.
-
-* link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide]
-* link:https://asciidoctor.org/docs/user-manual/[Asciidoctor User Manual]
+//Optional
+* A bulleted list of links to other material closely related to the contents of the procedure module.
+* Currently, modules cannot include xrefs, so you cannot include links to other content in your collection. If you need to link to another assembly, add the xref to the assembly that includes this module.
+* For more details on writing procedure modules, see the link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].
+* Use a consistent system for file names, IDs, and titles. For tips, see _Anchor Names and File Names_ in link:https://github.com/redhat-documentation/modular-docs#modular-documentation-reference-guide[Modular Documentation Reference Guide].