This one day course is intended for those technical communicators who are already familiar with DITA or are in the process of starting with DITA and want to improve their efficiency in organizing and managing DITA content.

By the end of the training day, you will be able to:

  • Identify the most effective ways to organize your content in maps
  • Use keyref’s and conkeyref’s to manage variable content
  • Understand which reuse method should be used in each particular case
  • Enforce consistency into the way you profile (conditionalize) content
  • Build a version control strategy
  • Organize source and translated projects

The course duration is 8 hours.

Session I. Organizing topics into maps

  1. What a DITA map represents
  2. Keeping everything in a single map vs. creating a separate map per deliverable
  3. Working with variables using keyref’s


Session II. Handling content variations

  1. Keyref vs. conref
  2. Conkeyref vs. keyref
  3. Conditional attributes vs. conkeyref


Session III. Managing versions

  1. Version control strategies
  2. Version control tools
  3. What version control can and cannot do. Version control vs. content management system
  4. Using baselines to control releases


Session IV. Translating DITA content

  1. Organizing the source and translated content without a content management system
  2. Organizing non-localizable content
  3. Using baselines for translations
  4. Using keyref’s for managing localizable strings (e.g., user interface labels)

The course can be adjusted to your specific needs. Please contact us at for details.