New LearningDITA course: reference and glossaries

Simon Bate / News2 Comments

Thank you all for your great response to our free DITA courses at (over 500 registrants and counting)! Now that you’ve got your feet wet with the Introduction, concept topic type, and task topic type courses, are you ready for the next challenge?

Dave Young - originally posted to Flickr as surfer chicks

Dave Young – originally posted to Flickr as surfer chicks

Today we are releasing another course in our series: The DITA reference and glossary topic types.

This new class on introduces three additional topic types: reference, glossary entry, and glossary group. The course and supporting videos were created by a Scriptorium team led by Jake Campbell (with help from Gretyl Kinsey and me).

The course includes four lessons on:

  • Lesson 1: Creating a reference topic
  • Lesson 2: Best practices for reference topics
  • Lesson 3: Creating a glossary topic
  • Lesson 4: Best practices for glossary entries

With guided exercises and on-your-own work, this course should help round out your familiarity with the common DITA topic types.

As always, we welcome additional content through the GitHub repository. Take a look at the project roadmap and see where you can contribute! To get notifications about new content on the site, sign up for announcements. You can also sign up during the site registration process.

Special thanks to the Learning DITA sponsors: oXygen XML Editor, The Content Wrangler, and easyDITA.

About the Author

Simon Bate


Involved in TechComm all my working life (since the time of vacuum tubes, core memory, punch cards, and bone implements). I've worked as a writer, a manager, and—for the past score of years—building software tools for TechComm. My motto is "Let the computer do the work." Outside of work, I balance the calories I create and consume in the kitchen with weight-training sessions at the gym. I also sing Tenor in various choirs and choruses.

2 Comments on “New LearningDITA course: reference and glossaries”

  1. You need to make the course more modular than sequential, as it is right now. When more complex or difficult topics are added there will likely be more people looking for those or wanting a refresher, but they won’t want to wade through a dozen lessons on basic concepts before they’re allowed to see the content they need.

    In other words, you forgot who the audience is (or includes).

  2. Hi Ben,

    We made these first few courses sequential because we felt that it was important to introduce (and require understanding of) basic concepts before moving on to more complex material.

    However, this does not mean that all our planned courses will follow as the continuation of a single sequence. We expect that future courses in LearningDITA will have a more modular approach.

    Thanks for the note,

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.