I and some of my colleagues have run into a few people at recent conferences who have been asking me how soon DITA 2.0 was coming and whether they should hold off moving to DITA until its arrival. While I understand where this type of question is coming from, it reveals a fundamental misunderstanding asRead More
Category: Articles
Feature articles by DITAWriter or by other contributors.
Book Excerpt: DITA and Other Structured XML formats
Current Practices and Trends in Technical and Professional Communication was published earlier this week in the U.K. by ISTC. Edited by Professor Stephen Crabbe, it is a book that surveys the current state of technical authoring. I was asked to contribute a chapter to the publication, which focused on DITA. My chapter is called “TheRead More
DITA Technical Documentation and SEO
I will be covering all of the points in this article and more in a webinar presentation on DITA and SEO at CIDM’s online IDEAS Summer Online Conference on July 25, 2017. I hope to see you there! There’s a joke making the rounds that goes like this: where is the best place to hideRead More
10 Reasons Why DITA and Agile are Made for Each Other
There are many key factors that make DITA-based technical documentation complementary to Agile-based product development. Here are 10 reasons, among many, why DITA and Agile make a great partnership: Topic-based approach in DITA assists with incremental development: One of the tenets of DITA is content reuse, encouraging technical writers to “write once, use many”. ThisRead More
ThunderBird: A Sample DITA Documentation Set to Play With
Here’s something I think needs to be more widely known: sample DITA files mimicking a professional manual set for a fictitious product called Thunderbird. I’ve been using this example code for a couple of years now in demos and for presentations, and there’s at least one person in every audience I show this to whoRead More
What I Learned from the DITA Listening Sessions (Part 1)
My work for IXIASOFT includes being a company liaison for OASIS, the open standards body that produces the DITA specification. One of the groups I actively work with there is the DITA Adoption Committee, that I now chair, accompanied by Stan Doherty as secretary. Its goals are to help inform the DITA community on bestRead More
Current Worldwide Distribution of DITA Users
My main source for finding new companies to add to my list of companies that use DITA on the DITAWriter website is LinkedIn. In order to answer the question: “where are DITA users located across the world?”, for the past few years I have done a broad search asking how many individuals claimed “DITA XML”Read More
What I Learned from the DITA Listening Sessions (Part 2)
This is part two of a series of articles examining the issues DITA users are talking about at the DITA Listening Sessions being held by the OASIS DITA Adoption Committee. Just few weeks ago I attended (virtually) two additional DITA Listening Sessions that occurred in the Seattle area. Each session is unique, in that itRead More
Five Highlights from DITA tcworld 2016
One of the final technical communications conferences in the fall is the biggest: tcworld which draws in over 4,000 attendees, mostly from Germany and across Europe. I came to the conference with some trepidation given that, last year, DITA experts and vendors attending the show got a largely frosty reception, with German CCMS vendors bonding togetherRead More
Agile Documentation Management at Best Practices 2016
This year’s Best Practices conference was held at in Santa Fe, New Mexico at the La Fonda Hotel, a grand old Pueblo-style hotel located in the heart of old Santa Fe. Anyone arriving to the conference early was treated to an open air market in the main square selling lots of turquoise jewelry, some veryRead More