Relationship Tables (RelTables)
Relationship tables in DITA maps define non-hierarchical links between topics, improving navigation in complex documentation.
Relationship tables are an advanced feature within DITA maps that allow you to explicitly define cross-references between topics that don't necessarily follow the hierarchical structure.
Purpose
In complex technical documentation, topics often need to reference related information that exists elsewhere in the hierarchy. Manually maintaining these cross-references becomes unmanageable as content grows. Relationship tables automatically generate appropriate links based on defined relationships.
Real-World Use
A troubleshooting topic might need to link to:
- Related concept topics explaining underlying principles.
- Task topics showing corrective procedures.
- Reference topics with relevant specifications.
Best Practice
Start with simple hierarchical organization, then add relationship tables as cross-referencing needs become clear. Over-engineering relationships early can create maintenance overhead.