Art of the Short Description

The short description is an optional element in DITA, but it has powerful usability implications. Carefully-written short descriptions can help readers more successfully navigate information and locate topics that answer their questions. In addition, the act of crafting careful short descriptions can help writers clarify their understanding of the technical content.

This session will cover:

  • How the content of the <shortdesc> element can be displayed in various forms of output
  • Practices for writing short descriptions that are concise, meaningful, and useful for readers
  • Best practices for specific information types: Concept, task, reference, API specializations, subjectScheme and more

Tools & Technologies
Location: Date: October 29, 2014 Time: 11:00 am - 11:45 am Kristen James Eberlein Kristen James Eberlein