Short description

A short description is text that briefly introduces and describes a topic. In DITA, short desciptions are tagged with the short description element (<shortdesc>).


<concept id="debuggingtools_overview">
<title>About the debugging, reporting, 
and file generation tools</title>

<shortdesc>Information about tools and techniques 
you can use to debug your processing problems, 
get information about your source files, 
and generate DITA files automatically from XML-based source code.</shortdesc>


The DITA short description is one device to achieve "progressive disclosure" in topic-based writing, in the sense that title expands to short description, which expands to the topic itself as a user drills into information. Consistent use of short description helps to provide this progressive user experience. The "short description" approach in writing topics could be compared with the "topic sentence" approach in writing paragraphs that is regularly taught in classes from elementary school through college.

The DITA short description has several functions (and reiterating the title is not one of them):