Just Write Click

Technical writing with Continuous Integration and docs-as-code

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code
You are here: Home / DITA / Notes from April 2008 Central Texas DITA User Group meeting

July 7, 2008 by annegentle

Notes from April 2008 Central Texas DITA User Group meeting

Better late than never, I suppose. I’ve had these notes on my hard drive and want to post them to the cloud of my blog.

John Hunt, DITA Architect in the Lotus Information Development Center at IBM and DITA Learning and Training Content Specialization SC chair, presented Using DITA Content for Learning Content Development at the April 2008 Central Texas DITA User Group meeting. He gave an overview of work being done on the new Learning and Training Content specialization that will be part of OASIS DITA 1.2 release. (Updated to add: see DITA Learning and Training Content Specialization SC for additional information and download links for the Open Toolkit Plug-in that contains the approved specialization.) He then followed up with a live demonstration of creating, assembling, and delivering topic-based learning and training content, delivered both as a SCORM-compliant package and as simple XHTML.

In the room we had about 20 Austin attendees and on the phone, a handful more in Ann Arbor, with John Hunt, our presenter, presenting from Massachusetts. He has worked with DITA for 9-10 years, but interestingly, has met Don Day in person only once.

Learning specialization will become a DITA standard in next OASIS release.

John led with a very recent newspaper article, about re-creating the Jefferson Library – “Re-created Library Speaks Volumes About Jefferson” Amy Orndorff, Washington Post, Apr 11, 2008 (John’s talk was on the 16th!) The library was given to the Library of Congress for $24,000 in 1815. Jefferson had created his own taxonomy – memory, reason, or imagination. Automatically, John wondered if you could parallels to reference, concept, or task. Ah ha!

Fascinating – Jefferson did mashups of books by tearing them apart, even different language books, and then would bind them into new books – reassembly of content 200 years ahead of his time.

Industry context – trends – smaller, faster, leaner for creating and delivering training content.
Content as reusable learning object helps… RLOs (Reusable Learning Objects) were developed at Cisco in the 1990s, similar to legos as building blocks – different structures with the same set of Legos.
LCMS (learning content management system) came into being.

Training can move from a “craft” approach to a DITA content approach, standard.
Craft = every deliverable unique, every context one-of-a-kind
Craft = presentation oriented, labor intensive
DITA = content and deliverables have consistent structures and patterns, so available for reuse and repurposing
DITA = collaboration and reuse becomes the norm

IEEE LOM (Learning Object Metadata) is a standard for the learning metadata domain. See ltsc.ieee.org/wg12/20020612-Final-LOM-Draft.html
Build maps + specialized processing = generated learning deliverables such as tutorials, courseware and e-learning, ILTs, SCORMs=mandated for training delivered to the U.S. Govt. (Dept. of Defense), Textbooks. In case you’re wondering, SCORM stands for Sharable Content Object Reference Model – SCORM is a set of specifications created by the Advanced Distributed Learning initiative (ADL). The ADL website has that SCORM runtime freely available, see www.adlnet.gov/downloads/.

Learning objects contain:
– Instructional objects: overview, content, summary, assessment
– Informational objects: concept, task, reference, also known as Facts, Concepts, Procedures, Principles

5 new DITA specializations as learning types – learningPlan, learningOvereview, learningContent, learningSummary, learningAssessment

Midnight at the OASIS – 32 members on the sub-committee, working drafts, Lang. Spec available for inclusion in DITA 1.2 (Nov 13, 2007)
Specializations of 5 topic types.
Also, three domains are available:

  • Learning interactions domains – open question, true/false, single select, multiple select, matching, sequencing, hotspot.
  • Learning map domain – learning objects and groups, makes learning content available for use in any DITA map
  • Learning metadata domain – makes learning metadata available for use in learning topics and maps.

What does DITA bring to learning content?
Consistency all around (content, processing, delivery)
Can grow as DITA grows – add a Flash object

DITA vision – a platform for collaboration

DITA specialized tags contain “lc” for learning content – lcAudience, lcObjectives, lcDuration, lcPrereqs, lcChallenge (instructions follow that address that challenge), and so on.

Manifest file informs the navigation that is then imported inside the zip file into a sample run-time environment – Advanced Distributed Learning. Has Suspend and Quit buttons, as well as Previous and Continue buttons. Assessment section has questions, true and false with javascript that lets you find out if your response is correct or not.

He showed an embedded Youtube video using the DITA object tag within the Summary object. See Double bonus slide for embed code.

Q: Are you re-inventing the wheel with DITA since scorm and ilm are already standards.
A: Scorm is a packaging and delivery standard. Scorm is silent with regard to content.

Eliot Kimber, Really [ ] Solutions, uses the DITA solution for practice test books for each states – remapped element names to new element names and he gets all the SCORM online assessments pretty much for free because he’s using DITA. Nice.

Related

Filed Under: DITA Tagged With: content management, ctdug, DITA, education, learning objectives, SCORM, training

More reading

Bubble graph showing sources of developer support data

I’ve been thinking a lot about developer support at Cisco recently, especially for the way the world works today with multiple cloud providers. This post is a re-publish of my talk from over five years ago, but the techniques and tools for listening and helping others are still true today. At Rackspace, we watched several […]

Cisco DevNet is our developer program for outreach, education, and tools for developers at Cisco. From the beginning, the team has had a vision for how to run a developer program. Customers are first, and the team implements what Cisco customers need for automation, configuration, and deployment of our various offerings. Plus, the DevNet team […]

I had a great talk with Ellis Pratt of Cherryleaf Technical Writing consulting last week. Here are the show notes, full of links to all the topics we covered. Podcasts are great fun to listen to and participate in, if a bit nerve-wracking to think on your feet and make sure you answer questions succinctly […]

At the beginning of this year, I worked hard to summarize my thoughts on API documentation, continuous publishing, and technical accuracy for developer documentation. The result is an article on InfoQ.com, edited by Deepak Nadig, who also was forward-thinking in having me speak to a few teams at Intuit about API documentation coupled with code. Always […]

Recently on Just Write Click

  • A Flight of Static Site Generators: Sampling the Best for Documentation
  • Try a GPT about “Docs Like Code” to ask questions
  • Discipline and Diplomacy: Docs in the Open
  • Let’s Find Out: When Do Static Site Generators Do Rendering?
  • GitHub for Managing Tech Docs

Just Write Click in your Inbox

Enter your email address to subscribe to Just Write Click and receive notifications of new posts by email.

Read More

  • Privacy Policy
  • About Anne Gentle, developer experience expert
  • Books by Anne Gentle
    • Conversation and Community
    • Docs Like Code, a Book for Developers and Tech Writers
  • Woman in Tech Speaker Profile
  • Contact

Books

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code

Copyright © 2026 · WordPress · Log in