|Language and punctuation / Titles and headings|
Writing accurate, concise and consistent topic titles is an important challenge for DITA authors. Guidelines for crafting title text make this task a little easier.
In topic-based authoring, chunks of information have a greater need to be self-supporting, or standalone. This means that topics should be able to be read on their own, without reliance on what comes before or after. A topic with a heading of "Introduction" cannot be standalone, because it doesn't adequately describe what the topic is about. "Introducing the Supara Liberty" is a better label.
The greater importance of titles in semantic, structured authoring environments means that labelling (and other forms of cataloguing) needs to be thorough, and time and skill must be devoted to crafting meaningful titles.
In addition to helping the reader understand what a topic is about, titles should also help the reader identify what kind of topic it is. From the topic title, readers should know whether the topic will help them understand something, help them do something, or provide supporting information. This can be done by using different phrasing for titles for topics of different information types.
Titles must be meaningful, easy to read, accurate, concise and consistent.
When composing titles, try constructing them as sentence fragments. A useful technique is to re-write the title after the content of the topic and the short description are complete.
|Concept||Start with a noun or adjective||"Client window", "Supara Liberty features", "Important Considerations for Engine Modifications"|
|Task||Start with a gerund or present participle, and use singular nouns||"Resetting the odometer", "Printing the audit report"|
|Reference||Start with a noun or adjective, and include the reference construct (eg, "table", "list", etc)||"Specification table", "Product code list"|