Diff for Writing DITA topics

Tue, 2007-09-18 23:05 by syeoTue, 2007-09-18 23:05 by syeo

Copy of the revision from Thu, 2007-06-21 20:45.

Changes to Title
-
DITA Topics and Information Typing
+
Writing DITA topics
Changes to Body
Line 1Line 1
-
<p>DITA topics are the basic units of DITA content.</p>
+
<p>
-
<p>Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.</p>
+
DITA topics are the basic units of DITA content.
-
<p>Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.</p>
+
</p>
-
<p>As stated in the <a href="http://dita.xml.org/arch-intro">Introduction to the DITA architecture</a>, <a href="http://dita.xml.org/arch-topics">DITA topics</a>&nbsp;are organized by <a href="http://dita.xml.org/arch-maps">DITA maps</a>. It is also possible to nest sub-topics within a topic. <a href="http://dita.xml.org/arch-specialization">Specialization</a> enables the creation of specialized&nbsp;topics and other units of content that are tailored to particular structural requirements. <a href="http://dita.xml.org/arch-conref">Content referencing (conref)</a> enables fragments of content to be reused from a single source. <a href="http://dita.xml.org/node/1104">Conditional processing</a> permits a single source to support the needs of multiple audiences.</p>
+
<p>
-
<p>The architectural specification describes topics and information typing at</p>
+
Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.
  +
</p>
  +
<p>
  +
Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.
  +
</p>
  +
<p>
  +
As stated in the <a href="/arch-intro">Introduction to the DITA architecture</a>, <a href="/arch-topics">DITA topics</a> are organized by <a href="/arch-maps">DITA maps</a>. It is also possible to nest sub-topics within a topic. <a href="/arch-specialization">Specialization</a> enables the creation of specialized topics and other units of content that are tailored to particular structural requirements. <a href="/arch-conref">Content referencing (conref)</a> enables fragments of content to be reused from a single source. <a href="/node/1104">Conditional processing</a> permits a single source to support the needs of multiple audiences.
  +
</p>
  +
<p>
  +
The architectural specification describes topics and information typing at
  +
</p>
 
<ul>
 
<ul>
-
<li><font face="Lucida Sans Unicode" size="2"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html">http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html</a>.</font> </li>
+
<li><span style="font-size: x-small; font-family: Lucida Sans Unicode"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html">http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html</a>.</span> </li>
 
</ul>
 
</ul>
-
<p>Editors for the Architecture area:</p>
+
<p>
  +
Editors for the Architecture area:
  +
</p>
 
<ul>
 
<ul>
-
<li><a title="View user profile." href="http://dita.xml.org/user/26"><strong><font color="#ac083e">Bruce Esrig</font></strong></a> </li>
+
<li><a href="/user/26" title="View user profile."><strong><span style="color: #ac083e">Bruce Esrig</span></strong></a> </li>
-
<li><a title="View user profile." href="http://dita.xml.org/user/25"><strong><font color="#ac083e">Michael Priestley</font></strong></a> </li>
+
<li><a href="/user/25" title="View user profile."><strong><span style="color: #ac083e">Michael Priestley</span></strong></a> </li>
-
</ul>
+
</ul>
  +
 
Revision of Tue, 2007-09-18 23:05:

Writing DITA topics

DITA topics are the basic units of DITA content.

Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.

Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.

As stated in the Introduction to the DITA architecture, DITA topics are organized by DITA maps. It is also possible to nest sub-topics within a topic. Specialization enables the creation of specialized topics and other units of content that are tailored to particular structural requirements. Content referencing (conref) enables fragments of content to be reused from a single source. Conditional processing permits a single source to support the needs of multiple audiences.

The architectural specification describes topics and information typing at

Editors for the Architecture area:

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I