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>

Sponsored content