I think we need to do a little more finessing around the
editions.
3.2.1 Basic topic elements:
The shortdesc reads "The generic topic structure is used
for untyped topics. While much of the DITA architecture is
built on generic topics, it is generally better to use
more specific information types (such as concept, task, or
reference) when they are available." Let's recast this for
the base edition?, which does not include concept, task,
and reference. This simply will require conditionalizing
the content of the <shortdesc> for the three
editions.
3.2.1.1 <topic>:
Probably should exclude the following sentence from the
short description in the base edition: "Other top-level
DITA elements that are more content-specific are
<concept>, <task>, <reference>, and
<glossentry>, all of which are specializations of
the <topic> element."
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)
| Reply via web post | • | Reply to sender | • | Reply to group | • | Start a New Topic | • | Messages in this topic (1) |