DITA Overview Topics Showing on Same Level as Children Topics

Issue

Customer will have an "Overview" type topic that they want to appear at the top level of the TOC. However, this topic gets shown at the same level as the other topics.

Resolution

This is an authoring issue. What you will need to do is modify the topicref elements to have the child topics to nest under that overview/about topicref you want at the parent level, for example:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd" [
]>
<map type="map" title="Introduction to the System and its Documentation">
<topicref href="c_ExampleOverview.dita" type="concept">
<topicref href="c_ExampleConcept.dita" type="concept"></topicref>
<topicref href="c_ExampleConcept2.dita" type="concept"></topicref>
<topicref href="r_ExampleReference.dita" type="reference"></topicref>
<topicref href="ta_ExampleTask.dita" type="task"></topicref>
</topicref>
</map>

Notice the ending <topicref> tag is the closing tag for the <topicref href="c_ExampleOverview.dita" type="concept"> If you change the ditamap to do that, and rescan the documents, you will see the Title/Heading 1 styles listed in the style designer. Change the TOC level to 2 for the "Heading 1" option and then you will see the levels set to how you want them.