Every day, organizations that are using desktop publishing and are just learning about DITA XML drop by our website looking for information. The first thing we say to these readers is: If you haven’t done your homework on DITA yet, then it’s way too early to be looking at technology.
Before looking for a DITA tool, it’s important to understand DITA itself and find out if it’s right for you.
Now that we’ve gotten that out of the way, let’s suggest some things you can do to get off on a good foot. The transition from unstructured authoring (e.g. desktop publishing) to structured authoring is significant, and the change costs are non-trivial.
Before you evaluate technologies, you need to determine if DITA is right for you.
How Do I Know If DITA Is Right for Me?
- Does my organization reuse content? – e.g., do we reuse content between products or different types of publications like training and manuals?
- Do we deliver content in multiple languages?
- Do we publish to different types of audiences?
- Do you require an audit trail for documentation?
- Do we struggle to maintain consistency between documents?
- Do we have difficulty keeping documents up to date?
- Do we have problems keeping documents in a shared location? – e.g., a single source
- Do we deliver content in multiple formats (print, PDF, help, web, mobile, etc.) from a single source?
If you answered “yes” to one or more questions, DITA might be a great fit for you. The more “yeses” the stronger your case for DITA.
If DITA is Right for You…
If you’ve determined that you can benefit from component content, and that DITA is right for you, there is still learning to do and preparations to make before you can transition from desktop publishing to productively using any DITA solution. Here’s our recommendations for a successful DITA implementation:
Learn More About DITA
If you’ve never used structured authoring solutions before, you should take some time to understand the differences in information development methods – and writing styles – for component-oriented content. There are a number of books on the market that lead you through best practices for creating reusable content. We suggest you explore Minimalism and Writing For Reuse as topics of interest to your information developers, and read books and attend learning events like a DITA Boot Camp. You can see recommended events past and upcoming here.
We recommend The Content Wrangler Community for starters.
Develop a Content Strategy
This means understanding how content will be reused, localized, managed, and delivered. A complete content strategy will define a workflow that assures content quality and compliance with your requirements. It will validate whether and why you should transition from desktop publishing to DITA, and will outline the Return on Investment. A complete content strategy will also define a transition plan for how to address legacy content, and how and when to convert that content to DITA. There are a number of consultants that specialize in Content Strategies for component content in general, and DITA in specific. Find one to help you develop a content strategy (we can recommend several if you like). Watch a webinar with Sarah O’Keefe on the importance of having a content strategy up front.
Develop a Content Model
A content model is a “data structure” for document-oriented content. it defines how content will be reused. For DITA projects this means deciding on whether you require a DITA specialization or not, and implementing a “flavor” of DITA that meets your needs. In some cases this means extending DITA, but in just as many it can mean defining the subset of DITA that meets your needs. This is something else a DITA consultant can help you with.
Document your Technology Requirements
Once you have a content strategy and content model, you can develop your essential requirements for authoring, content management, collaboration, and publishing technology. Be sure to make strong distinctions on what is essential and what is “nice to have”. Use these requireme