<audience> metadata element indicates, through the value of
@type attribute, the intended audience for a topic.
Since a topic can have multiple audiences, you can include multiple audience elements. For
each audience you specify, you can identify the high-level task they are trying to
accomplish with the
@job attribute, and the level of experience expected
@experiencelevel attribute. The
<audience> element can be used to
provide a more detailed definition of values used throughout the map or topic on the
Many of the attributes on the
<audience> element have enumerated
values, which can be restricted by using constraints or
extended by using associated attributes. For instance, the
attribute can be used to extend the audience type enumeration.
See appendix for information about this element in OASIS document type shells.
For a command reference topic for experienced programmers, the following might be an appropriate indication of that audience:
<audience type="programmer" job="programming" experiencelevel="expert"/>
The following attributes are available on this element: Universal attribute group and the attributes defined below.
@typeattribute on many other DITA elements. Beginning with DITA 1.2, values in this attribute are not limited to a small number of choices; the following values were used in DITA 1.0 and DITA 1.1, and are still provided as sample values: user, purchaser, administrator, programmer, executive, services, other, and -dita-use-conref-target.
@typeattribute value list. This value is used as the user-provided audience when the
@typeattribute value is set to "other."
@jobattribute value is "other" the value of this attribute is used to identify a kind of job other than the default ones provided by the
<audience>element with values used in the
Return to main page.
Standards Track Work Product
|Copyright © OASIS Open 2016. All Rights Reserved.||25 October 2016|