WIP: issue-116-emily #116: Guideline against "pseudo modules" is problematic

modular-docs-manual/content/topics/mod-docs-conversion.adoc

@@ -5,7 +5,6 @@ If you have a monolithic, feature-based manual, you can convert it to a set of m
 
 The result is documentation that is more relevant for your readers, because it is based on real-world user stories (it tells them how to accomplish their goals), and modular (it can be assembled into whatever sets and formats they might need).
 
-
 .Prerequisites
 
 * You should understand what modular documentation is:

modular-docs-manual/content/topics/module_what-modular-documentation-is.adoc

@@ -1,7 +1,7 @@
 [id="what-modular-documentation-is"]
 = What Modular Documentation Is
 
-Modular documentation is documentation based on _modules_, which the writer combines into _assemblies_. An assembly can also include other assemblies.
+Modular documentation is documentation based on _modules_, which the writer combines into _assemblies_. An assembly can also include other assemblies. A module should not contain another module.
 
 [IMPORTANT]
 ====

modular-docs-manual/content/topics/using-text-snippets.adoc

@@ -0,0 +1,21 @@
+[id="using-text-snippets"]
+
+= Text Snippets
+
+A text snippet is a small section of text that is stored in an AsciiDoc file. Text snippets contain content that is resused in multiple modules or assemblies, for example:
+
+* A step or series of steps in a procedure
+* A disclaimer, for example, for technology preview or beta releases
+
+NOTE: A text snippet is not a module.
+
+.Procedure
+. Create the text snippet AsciiDoc file.
++
+NOTE: Consider storing snippet files in a separate snippets folder.
+. Add an `include::` statement to the file that you want to add the snippet to, for example:
++
+[source]
+----
+include::snippets/beta-note.adoc
+----

modular-docs-manual/content/topics/writing-mod-docs.adoc

@@ -13,6 +13,8 @@ Follow these guidelines to create different types of modules:
 * xref:creating-procedure-modules[Procedure Module]
 * xref:reference-module-guidelines[Reference Module]
 
+A module should not contain another module. However a module can contain a text snippet. For information about text snippets, see xref:using-text-snippets[Using Text Snippets].
+
 See <<appendix-examples>> for real-world examples of assemblies, modules, and their individual parts.
 
 include::creating_concept_modules.adoc[leveloffset=+2]
@@ -21,7 +23,7 @@ include::creating_procedure_modules.adoc[leveloffset=+2]
 
 include::creating_reference_modules.adoc[leveloffset=+2]
 
-include::using_text_snippets_or_text_fragments.adoc[leveloffset=+2]
+include::using-text-snippets.adoc[leveloffset=+2]
 
 include::module_anchor-and-file-names-concept.adoc[leveloffset=+2]