Your SlideShare is downloading. ×
Using Dita To Provide Consistent Communications To The Public
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Introducing the official SlideShare app

Stunning, full-screen experience for iPhone and Android

Text the download link to your phone

Standard text messaging rates apply

Using Dita To Provide Consistent Communications To The Public

441
views

Published on

A slightly beefier version of a presentation that I gave at the XML in Practice conference in Arlington, VA on October 1st. It discusses how a Federal Agency is working to implement DITA to solve …

A slightly beefier version of a presentation that I gave at the XML in Practice conference in Arlington, VA on October 1st. It discusses how a Federal Agency is working to implement DITA to solve their publishing needs, and the tools involved.

Published in: Technology

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
441
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Using DITA to Provide Consistent Communications to the Public
    Laurence Hart
    Washington Consulting, Inc.
  • 2. Agenda
    Introduction
    The Plan for the System
    The Challenges and Lessons Learned
    Wrap-up
  • 3. The Problem
    The goal of government is to serve the people….
    …but paper seems to be a key output.
    LOTS OF PAPER!!!
  • 4. Government Publication Challenges
    Evolving formats over the years
    WordStar > Word Perfect > Word
    Physical storage for paper records
    Content creation is process intensive
    Consistency between publications is hard to maintain
  • 5. Enter DITA
  • 6. DITA at 10,000 Feet
    Darwin Information Typing Architecture
    XML publishing based on Topics
    Each Topic is written to stand alone
    Three Topic types: Task, Concept, and Reference
    Originally created by IBM
    Donated to OASIS
    http://dita.xml.org
    Reuse of content is a key driver for implementing DITA
  • 7. Publication Project Background
    Federal Agency publishes lots of content
    Manuals: Internal users
    Guidelines: External users
    Historically authored in Word
    Cut-and-paste into XML for print processing
    Publish as PDF and HTML
    Published on cycle
    Manual and repetitive process
  • 8. The Agency’s Plan
    Move all publications to DITA
    Standardize the structure of all publication content
    Enable reuse of content between publications
    Increase publication output channels
    Keep PDF for print
    Add Interactive Electronic Technical Manuals for large documents
    Identify supporting tools
    EMC Documentum Content Server (including X-Hive, now XDB)
    Quark XPress Author
    XyEnterprise XPP (already owned)
  • 9. High-Level System Design
  • 10. Challenges and Lessons Learned
  • 11. Content Creation Challenges
    Authors liked their Word styles
    Software is licensed per user
    Authors and reviewers throughout entire agency
    Not enough need to give license to everyone for once a year task
    Quark Express needed to be configured
    Training required for those configuring
    Defining the styles and formats was an iterative process with Authors
    Authors don’t trust automatic content reuse
    XML editor specific tags not handled consistently by editors
  • 12. Content Publication Challenges
    Interfacing Documentum to XPP
    Used Web Services
    Development required to automate the interface for users
    Assembling DITA Topics for publication
    Manuals consist of multiple topics
    Need to be able to publish manuals as sections or completely
    Separate reviews for publication content and formatted output
    Section 508 compliance reviews are time consuming and require coordination
  • 13. Key Lessons
    Focus on the Authors, their acceptance of the new processes and technologies is critical
    Invest in tools, if things are too hard to use or don’t work right, people will switch back to Word
    Training is critical
    One step at a time, don’t move everything to DITA at once
  • 14. Future Plans for the System
    Manage images natively in Documentum
    Now “managed” on desktops and email
    More dynamic publishing
    Remove schedule and update the print PDF automatically
    Increase reuse
    Switch for notifications of change to shared content sources
  • 15. Thank You