Skip to main content
Learning content LearningDITA Podcasts Structured learning content

LearningDITA: DITA-based structured learning content in action

Are you considering a structured approach to creating your learning content? We built LearningDITA.com as an example of what DITA and structured learning content can do! In this episode, Sarah O’Keefe and Allison Beatty unpack the architecture of LearningDITA to provide a pattern for other learning content initiatives.

Because we used DITA XML for the content instead of the actual authoring in Moodle, we actually saved a lot of pain for ourselves. With Moodle, the name of the game is low-code/no-code. They want you to manually build out these courses, but we wanted to automate that for obvious reasons. SCORM allowed us to do that by having a transform that would take our DITA XML, put it in SCORM, and then we just upload the SCORM package to Moodle and don’t have to do all the painful things of, you know, “Let’s put a heading two here with this little piece of content.” And the key thing is that allowed us to reuse content.

Allison Beatty

Read More
DITA LearningDITA Webinar

Discovering the Basics of DITA with LearningDITA (webinar)

In this webinar, Sarah O’Keefe shares the basics of DITA—what it is, why it’s crucial for creating structured content, and how it revolutionizes consistency and efficiency in documentation. By exploring core elements such as topics, maps, and metadata, along with DITA specializations like task, concept, and reference topics, you’ll learn why organizations around the globe use DITA to craft modular, reusable content and put it to work.

You’ll be introduced to a self-paced, online DITA training resource called LearningDITA. Lessons include exercises, links to additional resources and videos, and quizzes to test your knowledge.

What DITA offers is a mechanism for extensibility that doesn’t break the standard. If you’re going to try to build out a system that is futureproof, as best we can without knowing the future, then we need flexibility. We need the ability to change things as we go, to extend, to add new output types, to add new semantics, to add new metadata, to add new systems into the equation.

— Sarah O’Keefe

Read More
DITA Podcasts

LearningDITA: What’s new and how it enhances your learning experience

In this episode, Alan Pringle, Gretyl Kinsey, and Allison Beatty discuss LearningDITA, a hub for training on the Darwin Information Typing Architecture (DITA). They dive into the story behind LearningDITA, explore our course topics, and more.

Gretyl Kinsey: Over time that user base grew and grew. And now it boggles my mind that it got all the way up to 16,000 users. I never expected it to grow to that size.

Alan Pringle: Well, we didn’t really either, nor did our infrastructure. Because as of late 2024, things started to go a little sideways, and it became clear our tech stack was not going to be able to sustain more students. It was very creaky. The site wasn’t performing well. So we made a decision that we needed to take the site offline, and we did, to basically redo it on a new platform.

Read More
DITA

The PDF landscape for DITA content

I found this article in the 2010 (!!) archives and have updated it. Surprisingly, the general gist is still accurate.

There are numerous alternatives for producing PDF output from DITA content. The approach you choose will depend on your output requirements—do you need images floating in text, sidebars, and unique layouts on each page? How often do you republish content? How much content do you publish? Do you need to create variants for different audiences? Do you provide content in multiple languages?

Read More

Webinar: Discovering the Basics of DITA with LearningDITA

Join Sarah O’Keefe for “Discovering the Basics of DITA with LearningDITA” a free webinar tailored for technical writers who want to learn how to create content in accordance with the Darwin Information Typing Architecture (DITA). You’ll discover the essentials of DITA—what it is, why it’s crucial for creating structured content, and how it revolutionizes consistency and efficiency in documentation.

By exploring core elements such as topics, maps, and metadata, along with DITA specializations like task, concept, and reference topics, you’ll learn why organizations around the globe use DITA to craft modular, reusable content and put it to work.

Attendees will be introduced to LearningDITA—a self-paced, online DITA training course. Lessons include exercises, links to additional resources and videos, and quizzes to test your knowledge.

Register for the webinar here.

Read More