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 / talk.bmc / Darwin Information Typing Architecture – DITA (dih tuh)

November 4, 2005 by annegentle

Darwin Information Typing Architecture – DITA (dih tuh)

Roundup of the DITA reading I’ve been diving back in to lately

Here’s a rough grouping of some interesting articles I’ve been reading about DITA implementations lately. BMC has explored DITA implementations for both mainframe and distributed documentation, modeling the information for a couple of books. I’ve been looking at DITA case studies this week.

This article about Adobe’s journey into DITA-land, “Adobe Systems Speaks Out on DITA: Internal use of FrameMaker, CMS, and DITA” offers insight from an information architect at Adobe. Re-use for solutions-type documentation was Adobe’s main goal and the article describes the percentage of re-use that Adobe got out of structured authoring. Scott Abel, The Content Wrangler, posted about this case study originally in DITA at Adobe — The Good, the Bad, and the Ugly. (but he doesn’t have trackbacks built in to his blog, bummer.)

Since there aren’t a lot of companies using DITA yet, this additional case study (well, interview with an implementer) is pure gold. Off the top of my head, I think it’s generally known that Nokia’s using DITA, IBM invented it so they use it, and France Baril, Documentation Architect at IXIASOFT, implemented DITA for doc for CEDROM-SNi, a Canadian on-line content company. Today I learned that Autodesk uses it as well from this entry on the Gilbane Report Blog. And then, with a little more Google searching, I found a blogger who’s looking at DITA from the globalization standpoint, John Yunker. When DITA became an OASIS standard in June, John Yunker posted about it in his blog, trying to find more case studies. Don Day, the Chair for OASIS DITA Technical Committee and IBM Lead DITA Architect, notes that “you can find case studies from IBM (Michael Priestley, Susan Carpenter, Ian Larner), Ixiasoft (France Baril), Nokia, and others. In fact, among the references is a Gilbane whitepaper commissioned by Idiom about their work with IBI on a DITA implementation.” I’ve linked directly to the case studies that Don refers to, hoping that the URLs remain accurate. It’s a lot of reading material but worth digging in to.

Related

Filed Under: talk.bmc Tagged With: case study, DITA, DITA case study, technical writing

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 © 2025 · WordPress · Log in