One of the projects I have been working on for a while is a list of CMSes that claim in some way to be DITA-capable, done largely because no such list seems to exist elsewhere. One of the things I have discovered in the process of surveying various CMS marketing materials is that it isRead More
Category: Articles
Feature articles by DITAWriter or by other contributors.
What Size Should a DITA Topic Be?
When I was first investigating how DITA XML was being used by others at conferences in the mid-2000s, one of the questions that always came up at the end of a session was: “how big should a DITA topic be?” Even at the time I thought that this was kind of a silly question, sinceRead More
Specializing Conref Target Topics to Avoid Spaghetti Code
While doing some DITA training recently for a client I ran across an idea that struck me as being a good way to avoid spaghetti code. In retrospect, it’s one of those obvious “why didn’t I think of that?” ideas: a specialized topic just for holding conref-able text. But first, I ought to explain whyRead More
Moving from One DITA CMS to Another: Lessons Learned from Migrating from a First-Generation to a Second-Generation DITA CMS
One of the most interesting presentations I saw at the Ixiasoft DITA CMS conference back in June was presented by a Documentation Team Lead at Research in Motion (RIM). While these days the beleaguered firm is better known in the news for its revenue woes (though it is good to see some wins as well),Read More
“DITA Today and Tomorrow” Presentation Now Available from YouTube
The Webinar presentation I did yesterday afternoon on behalf of Data Conversion Laboratory has now been posted to YouTube. You can now watch this anytime. Enjoy! For those who just want the slide deck, here’s a copy of the PDF, and here’s a link to the original Prezi that it was derived from. Will beRead More
Interactive Map of DITA Usage Worldwide Added
Currently I am working on updating the stats and images for my upcoming BatchGeo later this week, using the updated info from the Companies Using DITA listing. One of the things I wasn’t happy with was showing the worldwide and regional distribution of where the firms/organizations using DITA are located. I had been usingRead More
“Companies Using DITA” Listing Tops 300 Firms/Organizations
I just finished doing an overdue update to the popular “Companies Using DITA” listing, which now surpasses 300 firms and organizations, ranging from Abbott Laboratories to ZTE. This is likely still just the tip of the iceberg, as it is evident to me as I continue my research that there are many other companies andRead More
Countdown to the Content Management Strategies/DITA North America Conference
There’s just a few days to go before the big Content Management Strategies/DITA North America Conference in La Jolla, California. Am looking forward to presenting the keynote talk there, and to meet with other people in the industry and learn about the latest developments in DITA and technical documentation practice in general. I have learnedRead More
Some Thoughts on DITA-based Technical Writing Metrics
I liked a recent post on technical communications metrics on the the Mark Lewis blog recently, and while I don’t agree with the conclusion (any metric based on word counts and a subjective evaluation of quality is problematic IMHO) it did get me thinking about the topic of documentation metrics in general. I have doneRead More
Who is Using DITA?: DITA Usage by Industry Sector (Update)
(This article was originally published in CIDM Information Management News for March 2012. It is an update to a previous article by the same name on this site). It all started innocently enough with a simple question asked in a LinkedIn forum. I was looking for more information on companies that were using DITA forRead More