It is useful to take some time to structure your information in your DITA map. A well-organized structure can go a long way in helping your reader find and understand information. As such, it is useful to keep in mind the following guidelines.
As much as it applies to creating sections within topics, Miller’s law (an average person can only hold 7±2 objects in working memory) applies to creating structure in your DITA map. As such, it is advised to create a parent topic with around 7 child topics.
Additionally, the human mind can process about 4 concepts at a time, which means that when you start nesting topics, you should take care to create no more than four generations of topic families. The more you start nesting, the higher the chance the reader might start to lose track and forget how everything fits together.
When you are organizing your topics into groups, avoid using topic headings (topichead elements). Instead, use stub or summary topics: these are general topics that contain only a title.
This type of topic is automatically filled in with links to its child topics in output. If you want it to display content instead, you can use the @chunk attribute on this stub topic and enter the value ‘to-content’. This way all information from the child topics will be added to the stub topic in the output.
A stub topic as it appears in DITA:
The same stub topic as it appears in webhelp. It only includes links to its child topics:
The same stub topic with the attribute @chunk and the value ‘to-content’ added to it. The stub topic is automatically filled in with the information from the child topics:
To further enhance your structure, you can also use DITA maps nested within other DITA maps. This can help you organize your content more clearly by separating complex collections of topics into a number of smaller, simpler collections. You can, for instance:
Avoid nesting bookmaps within DITA maps as the structure will cause confusion for both processing software and documentation authors. Bookmaps should only be used at the top level.