Podcast -- DITA: From the Perspective of Someone Actually Using It
Listen here:
DITA is a topic I've wanted to do a podcast on for a long time. When I heard a local technical writer express her enthusiasm about how she was using DITA (Darwin Information Typing Architecture) at her company, I knew I found the right person.
In this podcast, Marlene Martineau of New Dawn Technologies explains why they adopted DITA, how they adopted it, the benefits they're experiencing, and the reasons why she'll never go back.
If you're unfamiliar with DITA, it's a way of tagging your content so that the DITA Open Toolkit can transform it into a number of outputs, such as HTML and PDF. The tags conform to a specific XML architecture, and your information is chunked into small topics that can be arranged in different tables of contents ("maps").
DITA is quickly becoming the XML standard for technical writers. New XML editing tools are sprouting up that allow you to more easily write DITA content without dealing with code. But Marlene says that she was on a budget; they opted for a more basic XML editor and actually write all their documentation in native XML. Rather than cumbersome, she says it's quite easy and only takes about a week before the writers become accustomed to it. The XSLT transforms posed more difficulties, she says, but nothing insurmountable.
Topics in this Podcast
Topics in this podcast include the following:
- DITA
- XML and XML editors
- DITA Open Source Toolkit
- topic-based authoring
- single sourcing
- XSLT and transforms
- Implementing DITA
- adopting DITA
Helpful Resources
- DITA.xml.org, an online community for DITA users
- The DITA Open Toolkit
- Bob Doyle's blog
- Stylus Studio XML Editor
- Introduction to DITA
To contact Marlene Martineau, send an email to [email protected]. We love to hear feedback, so if you enjoyed the DITA podcast, let us know.
About Tom Johnson
I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.
If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.