Merge pull request #249 from redhat-documentation/assembly-next-steps-issue-248

Issue 248: Remove Next steps from the assembly guidelines and template

Author: mjahoda

modular-docs-manual/content/topics/module_guidelines-assembly.adoc

@@ -34,7 +34,7 @@ Use the second level heading syntax for the Prerequisites section in the assembl
 [discrete]
 == Assembly modules
 
-To include modules in an assembly, use the Asciidoc  link:http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#include-files[include directive]. Use any combination of concept, procedure, and reference modules that fulfills the purpose of the assembly. Use the `leveloffset` attribute to set the hierarchy of the module relative to the assembly, as shown in the following example:
+To include modules in an assembly, use the Asciidoc link:http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#include-files[include directive]. Use any combination of concept, procedure, and reference modules that fulfills the purpose of the assembly. Use the `leveloffset` attribute to set the hierarchy of the module relative to the assembly, as shown in the following example:
 
 .Level offset for module files
 ----
@@ -46,11 +46,9 @@ file3.adoc[leveloffset=+3]
 All module and assembly titles must use the H1 heading designation, such as `= My heading`.
 
 [discrete]
-
-
-== Next steps and Additional resources
-These sections are optional. If you use both *Next steps* and *Additional resources*, list *Next steps* first. The listed resources link to other material closely related to the contents of the module, such as other documentation resources, instructional videos, or labs.
+== Additional resources
+This section is optional. The listed resources link to other material closely related to the contents of the module, such as other documentation resources, instructional videos, or labs. To ensure the content is DITA-compatible, do not use any non-link text in this section.
 
 Focus on relevant resources that might interest the user. Do not list resources for completeness. If a resource applies to all of the modules in a user story, consider listing the resource in the Additional resources section of the assembly file. If you do this, consider including the resource in the procedure module as a comment.
 
-NOTE: If you use *Next steps* or *Additional resources* in an assembly file, check whether the last module in the assembly also has *Next steps* or *Additional resources*. If so, view the rendered HTML and consider rewriting or reorganizing the assembly.
+NOTE: If you use *Additional resources* in an assembly file, check whether the last module in the assembly also has *Additional resources*. If so, view the rendered HTML and consider rewriting or reorganizing the assembly.

modular-docs-manual/content/topics/whats-new.adoc

@@ -11,18 +11,24 @@ For a complete list of changes, see link:https://github.com/redhat-documentation
 //
 // * <Brief description of change. Include an inline link to the relevant section of the guide.>
 // link:<URL of the GitHub issue associated with this change>
+[discrete]
+== 2026: February
+
+* Removed references the Next steps section from the assembly guidelines and template to avoid a confusing order in DITA.
+
 [discrete]
 == 2025: October
+
 * Removed references to the [discrete] tag for concept and reference modules.
 * Updated the optional sections in the Procedure module section.
 
-
 [discrete]
 == 2025: April
 
 * Removed 'Limitations' section from the Procedure section.
 * Updated the comments in the templates to provide guidance to prepare for migration to DITA.
 
+[discrete]
 == 2024: January
 
 * Removed the `*[role="_abstract"]*` tag from the templates (regression).

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

@@ -56,12 +56,6 @@ include::TEMPLATE_PROCEDURE_doing-one-procedure.adoc[leveloffset=+2]
 
 include::TEMPLATE_REFERENCE_reference-material.adoc[leveloffset=+2]
 
-== Next steps
-
-* This section is optional.
-* Provide information about the next steps the user might want to take.
-* This section can include text and links. 
-
 // If the last module included in your assembly contains an Additional resources section as well, check the appearance of the rendered assembly. If the two Additional resources sections might be confusing for a reader, consider consolidating their content and removing one of them.
 
 [role="_additional-resources"]