The shortdesc element is more important than it initially appears to be. Although optional, it's highly recommended that you use this tag. The shortdesc appears in several key places:
  • As a tooltip in links pointing to the page
  • As a description on a parent page containing child pages
  • As the summary that appears in search results
  • Possibly as context sensitive help (perhaps pulled as a tooltip to show in an interface with a link to learn more)

Here's an example:

<concept id="concept">
 <title>Wheel truing overview</title>
 <shortdesc>Truing your wheels requires you to tighten or loosen spokes with a spoke wrentch in a balanced pattern in order to change the shape of the wheel.</shortdesc>
 <conbody>
   <p>Blah blah blah...</p>
 </conbody>
</concept>

Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

follow us in feedly