Because each topic has a title and short description in addition to its full content, applications can provide progressive disclosure. For example, a user can hover over a link to see its short description and then decide whether to follow the link for the rest of the topic. Progressive disclosure also allows topics to be meaningfully browsed in a variety of viewing contexts, whether full-screen browsers, integrated help panes, infopops, or PDA screens.

Read more

A small concept example:
A minimal topic for field description in a dialog might look like this: <concept id="username">
<title><var>username>/var> input field</title>
<shortdesc>Enter your name or the name of the user for whom you are creating a record.</shortdesc>
</concept>

Read more

Read more

• Topic orientation: Information covering one subject with a specific intent
• Topic granularity: Discrete, self-contained units accessed independently
• Topic sets: Deliverables assembled from a pool of available topics
• Strong typing: Required structures with well-defined semantics for each kind of information — such as a Task with steps

Read more

Read more