Merge pull request #36384 from bergerhoffer/contrib-updates

Clarifying topic map is only for assemblies

Author: bergerhoffer

contributing_to_docs/contributing.adoc

@@ -93,7 +93,7 @@ are:
 * _openshift-webscale_
 
 These attributes can be used by themselves or in conjunction to conditionalize
-text within a topic document.
+text within an assembly or module.
 
 Here is an example of this concept in use:
 
@@ -156,17 +156,22 @@ branch against enterprise-3.11 to submit your changes.
 ====
 
 == Adding files to the collection
-After you create files, you must add them to the `_topic_map.yml` so
+After you create assembly files, you must add them to the `_topic_map.yml` so
 that the build system can render them. The documentation build system reads
 the `_distro_map.yml` from the main branch to determine
 which branches to build and then the `_topic_map.yml` file
 for each of the branches
 to construct the content from the source files and publish to the relevant
 product site at https://docs.openshift.com. The build system _only_ reads this
-file to determine which topic files to include. Therefore, all new topics that
+file to determine which topic files to include. Therefore, all new assemblies that
 are created must be included in the `_topic_map.yml` file in
 order to be processed by the build system.
 
+[NOTE]
+====
+Module files are included in the appropriate assembly files. Modules are not added directly to the `_topic_map.yml` file.
+====
+
 === Topic map file format
 The `_topic_map.yml` file uses the following format:
 
@@ -202,11 +207,11 @@ topic or topic group will appear in all product documentation versions.
 _openshift-origin,openshift-enterprise,openshift-online,openshift-dedicated,openshift-aro,openshift-webscale_.
 * The *all* value overrides other values, so _openshift-online,all_ is processed
 as *all*.
-<5> Topic name.
-<6> Topic file under the topic group dir without `.adoc`.
+<5> Assembly name.
+<6> Assembly file under the topic group dir without `.adoc`.
 <7> This topic is actually a subtopic group. Instead of a `File` path it has a
 `Dir` path and `Topics`, just like a top-level topic group.
-<8> Topics belonging to a subtopic group are listed just like regular topics
+<8> Assemblies belonging to a subtopic group are listed just like regular assemblies
 with a `Name` and `File`.
 
 == Next steps