<concept> element is the top-level
element for a topic that answers the question “what is?” Concepts
provide background information that users must know before they can
successfully work with a product or interface. Often, a concept is
an extended definition of a major abstraction such as a process or
function. It might also have an example or a graphic, but generally
the structure of a concept is fairly simple.
See appendix for information about this element in OASIS document type shells.
- topic/topic concept/concept
<concept id="concept"> <title>Introduction to Bird Calling</title> <shortdesc>If you wish to attract more birds to your Acme Bird Feeder, learn the art of bird calling. Bird calling is an efficient way to alert more birds to the presence of your bird feeder.</shortdesc> <conbody> <p>Bird calling requires learning:</p> <ul> <li>Popular and classical bird songs</li> <li>How to whistle like a bird</li> </ul> </conbody> </concept>
- An anchor point. This ID is usually required as
part of the
@conrefsyntax when cross referencing or reusing content within the topic; it also enables
<topicref>elements in DITA maps to optionally reference a specific topic within a DITA document. This attribute is defined with the XML Data Type ID.