dita: not just for tech docs ann rockley the rockley group
DESCRIPTION
©2007, The Rockley Group Inc. The Rockley Group sample clientsTRANSCRIPT
![Page 1: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/1.jpg)
DITA: Not just for Tech Docs
Ann RockleyThe Rockley Group
![Page 2: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/2.jpg)
©2007, The Rockley Group Inc.
The Rockley Group Inc.
Summer 2007
![Page 3: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/3.jpg)
©2007, The Rockley Group Inc.
The Rockley Group sample clients
![Page 4: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/4.jpg)
©2007, The Rockley Group Inc.
DITA Darwin Information Typing Architecture Why Darwin? Because it evolves (you can
modify/specialize it)
![Page 5: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/5.jpg)
©2007, The Rockley Group Inc.
DITA’s origin Developed primarily by IBM in a response to
the changing needs of the business: Shorter cycle times Reduced costs More outputs More flexibility Increased effectiveness of materials
IBM gave it to the “world”, now it is an OASIS standard
![Page 6: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/6.jpg)
©2007, The Rockley Group Inc.
Design Goals Move away from focus on books to multiple
content types Move towards the trend to minimalism Provide more flexibility in structures and
away from “monolithic” DTDs Support maximum REUSE
![Page 7: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/7.jpg)
©2007, The Rockley Group Inc.
Benefits of DITA Simplifies XML adoption Allows new ways of working Encourages standardization Greater product functionality
![Page 8: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/8.jpg)
©2007, The Rockley Group Inc.
Simplifies XML adoption Removes need to develop custom content
types Broader selection of standardized tools Adapts easily to changing information needs
![Page 9: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/9.jpg)
©2007, The Rockley Group Inc.
Allows new ways of working Facilitates intra-team collaboration, content
sharing, content integration Promotes reuse
![Page 10: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/10.jpg)
©2007, The Rockley Group Inc.
Encourages standardization Combine industry-specific vocabularies with
company-specific requirements Better consistency and quality
![Page 11: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/11.jpg)
©2007, The Rockley Group Inc.
The way DITA normally looks
![Page 12: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/12.jpg)
©2007, The Rockley Group Inc.
A friendlier DITA
![Page 13: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/13.jpg)
©2007, The Rockley Group Inc.
A more Word-like DITA
![Page 14: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/14.jpg)
©2007, The Rockley Group Inc.
Where we’re using DITA Marketing Web site materials Business analyst reports (print & Web) Financial Institution (web) eLearning materials Goverment
![Page 15: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/15.jpg)
©2007, The Rockley Group Inc.
Key Concepts XML Modular content objects Topics DITA (topic) maps Reuse
![Page 16: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/16.jpg)
©2007, The Rockley Group Inc.
XML The current “go to” technology for complex
information development Features:
Extensible Hierarchical Structural Separates content from format Open
![Page 17: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/17.jpg)
©2007, The Rockley Group Inc.
Modular content objects Information stored as chunks (topics) Topics to be reused as building blocks of
content Topics to be “typed” with predefined
structures
![Page 18: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/18.jpg)
©2007, The Rockley Group Inc.
Topic development All built on a single model of a generic topic Topic defines the elements that are common
to topics of all types Base DITA also includes the following
specialized types: Concept Task Reference
Specialized types define additional elements that are specific to the type
![Page 19: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/19.jpg)
©2007, The Rockley Group Inc.
Sample Concept
![Page 20: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/20.jpg)
©2007, The Rockley Group Inc.
Sample Task
![Page 21: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/21.jpg)
©2007, The Rockley Group Inc.
Sample Reference
![Page 22: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/22.jpg)
©2007, The Rockley Group Inc.
DITA (topic) maps Look like TOCs. Defines the organization, order, and
hierarchy of topics in an content type Provides pointers to topics (topics are not
embedded) Allows the same topic to appear in different
places in a single content type … topics can also appear in different maps
Can add information about topics in the map to provide additional context
![Page 23: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/23.jpg)
©2007, The Rockley Group Inc.
Sample Map
![Page 24: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/24.jpg)
©2007, The Rockley Group Inc.
Reuse Support for reuse is a key goal for DITA Topics are written as self-contained chunks Topics can be combined in different content
types to provide needed variations
![Page 25: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/25.jpg)
©2007, The Rockley Group Inc.
Summary: Topics and maps Topic Orientation
Topic: a unit of information that is meaningful when it stands alone
Maps Organization of a set of topics, typically
for different deliverables
Topics DITA maps Deliverables
![Page 26: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/26.jpg)
©2007, The Rockley Group Inc.
Differentiation (selection attributes) Used to produce similar yet different
deliverables Provides core content plus differentiations Works through attributes (e.g. “state = DC”)
![Page 27: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/27.jpg)
©2007, The Rockley Group Inc.
Content References Used when a piece of content, usually small,
needs to appear in many different places and must be consistent
Examples: Boilerplate text Definitions Policy statements
![Page 28: DITA: Not just for Tech Docs Ann Rockley The Rockley Group](https://reader036.vdocuments.us/reader036/viewer/2022062306/5a4d1b767f8b9ab0599b725e/html5/thumbnails/28.jpg)
©2007, The Rockley Group Inc.
Conclusion DITA is a content standard that is gaining
widespread acceptance DITA can be extended, you can create your
own component types and naming that match your content
DITA doesn’t have to be scary, it can look like MS Word
DITA makes sense in a non Technical Publications world