I believe that one of the best ways people learn is to get “hands on” and play with things at the code level in order to get a real understanding as to how things are supposed to work. That’s the approach I took when devising a set of Lightweight DITA (LwDITA) code samples, which areRead More
Category: Articles
Feature articles by DITAWriter or by other contributors.
SIGDOC 2017: Educating Tomorrow’s Technical Communicators
While I get a lot of conference invitations, I was particularly intrigued when I received an invitation out-of-the-blue to present at the SIGDOC 2017 conference in Halifax. SIGDOC (which stands for “Special Interest Group on Design of Communication”) is a conference hosted by the Association for Computing Machinery (ACM) and is considered to be primarilyRead More
Don’t Wait for the DITA 2.0 Standard to Migrate to DITA
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
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