Diff for Why DITA?
Thu, 2006-10-12 21:20 by carolgeyer | Wed, 2007-11-28 09:46 by Bruce Esrig | ||
---|---|---|---|
Tags: Tutorial, Introduction, Structured authoring, Reuse, Publishing pipeline, Articles, Open toolkit | |||
< previous diff | next diff > | ||
Changes to Body | |||
Line 1 | Line 1 | ||
- | <p><font size="2">For some, perhaps the real question is <a href="http://www.google.com/search?q=%22why+XML%22&btnG=Search" target="_new">Why XML?</a> (or <a href="http://www.xml.com/pub/a/98/10/guide0.html" target="_new">What is XML?</a>), but assuming you have answered those questions (and are using XML), then the next step is to locate an appropriate data model for your content. This is an important step because you will spend a lot of time and money developing processes and selecting tools to support your chosen data model. XML, by definition, is extensible and allows you to create any valid structure that suits your needs, but before you decide to develop your own, consider the pre-existing options (see <a href="http://www.tbray.org/ongoing/When/200x/2006/01/08/No-New-XML-Languages">Don't Invent XML Languages</a> for a discussion on why not to develop your own). If you can leverage and build on top of someone else's work, why not?</font></p>
| + | <p>
|
- | <p><font size="2">DITA is a data model for authoring and publishing topic-based content. It was developed by IBM for internal use and has since been released to the open-source community (now under the guidance of OASIS). This architecture and data model were designed by a cross-company workgroup representing user assistance teams working throughout IBM. After an initial investigation in late 1999, the workgroup developed the architecture collaboratively during 2000 through postings to a database and weekly teleconferences. Since that time IBM has migrated thousands of pages of content to DITA. </font></p>
| + | <span style="font-size: x-small">For some, perhaps the real question is <a href="http://www.google.com/search?q=%22why+XML%22&btnG=Search" target="_new">Why XML?</a> (or <a href="http://www.xml.com/pub/a/98/10/guide0.html" target="_new">What is XML?</a>), but assuming you have answered those questions (and are using XML), then the next step is to locate an appropriate data model for your content. This is an important step because you will spend a lot of time and money developing processes and selecting tools to support your chosen data model. XML, by definition, is extensible and allows you to create any valid structure that suits your needs, but before you decide to develop your own, consider the pre-existing options (see <a href="http://www.tbray.org/ongoing/When/200x/2006/01/08/No-New-XML-Languages">Don't Invent XML Languages</a> for a discussion on why not to develop your own). If you can leverage and build on top of someone else's work, why not?</span>
|
- | <p><font color="#6699cc" size="2"><strong>But, why DITA? </strong></font><font size="2"><br />Well, assuming your content fits into the topic-based data model, DITA's increasing popularity means that more and more authoring and publishing tools will be developed to support that model. The <a href="http://sourceforge.net/projects/dita-ot/" target="_new">DITA Open Toolkit</a> allows you to generate many popular output formats (HTML, HTML Help, PDF, Java Help, etc.) from DITA-based content. If you develop your own data model, you'll have to pay to develop those transformations. DITA's modular architecture, supports efficient reuse of content at the word, phrase or topic level. DITA also has the concept of "specialization," which allows you to develop elements of your own that are based on core DITA elements. This helps you to customize DITA to support your particular types of content while continuing to take advantage of the base DITA tools and transformations. </font></p>
| + | </p>
|
- | <p><font size="2"><strong><font color="#6699cc">Learn more</font></strong><br />The following articles provide additional information:</font></p>
| + | <p>
|
+ | <span style="font-size: x-small">DITA is a data model for authoring and publishing topic-based content. It was developed by IBM for internal use and has since been released to the open-source community (now under the guidance of OASIS). This architecture and data model were designed by a cross-company workgroup representing user assistance teams working throughout IBM. After an initial investigation in late 1999, the workgroup developed the architecture collaboratively during 2000 through postings to a database and weekly teleconferences. Since that time IBM has migrated thousands of pages of content to DITA. </span>
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | <span style="font-size: x-small; color: #6699cc"><strong>But, why DITA? </strong></span><span style="font-size: x-small"><br />
| ||
+ | Well, assuming your content fits into the topic-based data model, DITA's increasing popularity means that more and more authoring and publishing tools will be developed to support that model. The <a href="http://sourceforge.net/projects/dita-ot/" target="_new">DITA Open Toolkit</a> allows you to generate many popular output formats (HTML, HTML Help, PDF, Java Help, etc.) from DITA-based content. If you develop your own data model, you'll have to pay to develop those transformations. DITA's modular architecture, supports efficient reuse of content at the word, phrase or topic level. DITA also has the concept of "specialization," which allows you to develop elements of your own that are based on core DITA elements. This helps you to customize DITA to support your particular types of content while continuing to take advantage of the base DITA tools and transformations. </span>
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | <span style="font-size: x-small"><strong><span style="color: #6699cc">Learn more</span></strong><br />
| ||
+ | The following articles provide additional information:</span>
| ||
+ | </p>
| ||
<ul>
| <ul>
| ||
- | <li><a href="http://www.oreillynet.com/pub/wlg/8072?wlg=yes">Going DITA</a> - <em>by Constantine Hondros Oct. 12, 2005 03:21 PM</em><br />This blog provides insights from a software developer currently involved in a project to migrate a mission-critical document corpus to the DITA architecture.<br /> </li>
| + | <li><a href="http://www.oreillynet.com/pub/wlg/8072?wlg=yes">Going DITA</a> - <em>by Constantine Hondros Oct. 12, 2005 03:21 PM</em><br />
|
- | <li><a href="http://xml.coverpages.org/ni2003-04-25-a.html">The Holy Grail of Content Reuse: IBM's DITA XML</a> - <em>Cover Pages, April 25, 2003</em><br />Robin Cover offers a clear, concise overview of DITA basics and benefits in this report. <br /> </li>
| + | This blog provides insights from a software developer currently involved in a project to migrate a mission-critical document corpus to the DITA architecture.<br />
|
- | <li><a href="http://www.infomanagementcenter.com/enewsletter/200512/feature.htm">Is DITA Going to Tip?</a> - <em>Center for Information-Development Management, JoAnn Hackos, PhD, Dec. 2005</em><br />This article explores the reasoning behind the adoption rate of DITA and other publishing technologies. <br /> </li>
| + | </li>
|
- | <li><a href="http://www-128.ibm.com/developerworks/library/x-dita6/?ca=dgr-lnxw02DITA">Why use DITA to produce HTML deliverables?</a> - <em>IBM developerWorks, 07 Oct 2003, Updated 28 Sep 2005</em><br />This article described advantages DITA provides for producing HTML content -- including easy global changes, portability through standards, superior linking and Web management, conditional processing, content and design reuse, and better writing through focused content. <br /> </li>
| + | <li><a href="http://xml.coverpages.org/ni2003-04-25-a.html">The Holy Grail of Content Reuse: IBM's DITA XML</a> - <em>Cover Pages, April 25, 2003</em><br />
|
- | <li><a href="http://www-128.ibm.com/developerworks/xml/library/x-dita1/">Introduction to the Darwin Information Typing Architecture</a> - <em>IBM developerWorks, 01 Mar 2001, Updated 28 Sep 2005</em><br />This document is a roadmap for DITA: what it is and how it applies to technical documentation. <br /> </li>
| + | Robin Cover offers a clear, concise overview of DITA basics and benefits in this report. <br />
|
- | <li><a href="http://www.arbortext.com/resources/dita_q_a.htm">DITA webinar, "What You Should Know About DITA"</a> - <em>Arbortext, April 28, 2004</em><br />DITA Q&A .. What is DITA?; What’s so great about DITA?; Does DITA allow for use of a custom DTD?; How much of the flexibility and reuse demonstrated during the presentation was due to DITA and how much simply to having XML source?; and more. <br /> </li>
| + | </li>
|
- | </ul> | + | <li><a href="http://www.infomanagementcenter.com/enewsletter/200512/feature.htm">Is DITA Going to Tip?</a> - <em>Center for Information-Development Management, JoAnn Hackos, PhD, Dec. 2005</em><br />
|
+ | This article explores the reasoning behind the adoption rate of DITA and other publishing technologies. <br />
| ||
+ | </li>
| ||
+ | <li><a href="http://www-128.ibm.com/developerworks/library/x-dita6/?ca=dgr-lnxw02DITA">Why use DITA to produce HTML deliverables?</a> - <em>IBM developerWorks, 07 Oct 2003, Updated 28 Sep 2005</em><br />
| ||
+ | This article described advantages DITA provides for producing HTML content -- including easy global changes, portability through standards, superior linking and Web management, conditional processing, content and design reuse, and better writing through focused content. <br />
| ||
+ | </li>
| ||
+ | <li><a href="http://www-128.ibm.com/developerworks/xml/library/x-dita1/">Introduction to the Darwin Information Typing Architecture</a> - <em>IBM developerWorks, 01 Mar 2001, Updated 28 Sep 2005</em><br />
| ||
+ | This document is a roadmap for DITA: what it is and how it applies to technical documentation. <br />
| ||
+ | </li>
| ||
+ | <li><a href="http://www.arbortext.com/resources/dita_q_a.htm">DITA webinar, "What You Should Know About DITA"</a> - <em>Arbortext, April 28, 2004</em><br />
| ||
+ | DITA Q&A .. What is DITA?; What’s so great about DITA?; Does DITA allow for use of a custom DTD?; How much of the flexibility and reuse demonstrated during the presentation was due to DITA and how much simply to having XML source?; and more. <br />
| ||
+ | </li>
| ||
+ | </ul>
| ||
+ |
Why DITA?
For some, perhaps the real question is Why XML? (or What is XML?), but assuming you have answered those questions (and are using XML), then the next step is to locate an appropriate data model for your content. This is an important step because you will spend a lot of time and money developing processes and selecting tools to support your chosen data model. XML, by definition, is extensible and allows you to create any valid structure that suits your needs, but before you decide to develop your own, consider the pre-existing options (see Don't Invent XML Languages for a discussion on why not to develop your own). If you can leverage and build on top of someone else's work, why not?
DITA is a data model for authoring and publishing topic-based content. It was developed by IBM for internal use and has since been released to the open-source community (now under the guidance of OASIS). This architecture and data model were designed by a cross-company workgroup representing user assistance teams working throughout IBM. After an initial investigation in late 1999, the workgroup developed the architecture collaboratively during 2000 through postings to a database and weekly teleconferences. Since that time IBM has migrated thousands of pages of content to DITA.
But, why DITA?
Well, assuming your content fits into the topic-based data model, DITA's increasing popularity means that more and more authoring and publishing tools will be developed to support that model. The DITA Open Toolkit allows you to generate many popular output formats (HTML, HTML Help, PDF, Java Help, etc.) from DITA-based content. If you develop your own data model, you'll have to pay to develop those transformations. DITA's modular architecture, supports efficient reuse of content at the word, phrase or topic level. DITA also has the concept of "specialization," which allows you to develop elements of your own that are based on core DITA elements. This helps you to customize DITA to support your particular types of content while continuing to take advantage of the base DITA tools and transformations.
Learn more
The following articles provide additional information:
- Going DITA - by Constantine Hondros Oct. 12, 2005 03:21 PM
This blog provides insights from a software developer currently involved in a project to migrate a mission-critical document corpus to the DITA architecture.
- The Holy Grail of Content Reuse: IBM's DITA XML - Cover Pages, April 25, 2003
Robin Cover offers a clear, concise overview of DITA basics and benefits in this report.
- Is DITA Going to Tip? - Center for Information-Development Management, JoAnn Hackos, PhD, Dec. 2005
This article explores the reasoning behind the adoption rate of DITA and other publishing technologies.
- Why use DITA to produce HTML deliverables? - IBM developerWorks, 07 Oct 2003, Updated 28 Sep 2005
This article described advantages DITA provides for producing HTML content -- including easy global changes, portability through standards, superior linking and Web management, conditional processing, content and design reuse, and better writing through focused content.
- Introduction to the Darwin Information Typing Architecture - IBM developerWorks, 01 Mar 2001, Updated 28 Sep 2005
This document is a roadmap for DITA: what it is and how it applies to technical documentation.
- DITA webinar, "What You Should Know About DITA" - Arbortext, April 28, 2004
DITA Q&A .. What is DITA?; What’s so great about DITA?; Does DITA allow for use of a custom DTD?; How much of the flexibility and reuse demonstrated during the presentation was due to DITA and how much simply to having XML source?; and more.