About a dozen or so years ago at a conference, there was a presentation about the practice of using keys in DITA, and when it came time for questions, someone in the crowd asked “Why don’t we just use variables like we do in FrameMaker?” Coming from a FrameMaker background, still being relatively new toRead More
Category: Articles
Feature articles by DITAWriter or by other contributors.
Converting Content and Coding DITA with Claude AI
For several years a key focus of artificial intelligence (AI) as applied to technical documentation has been on using it as a basis for chatbots. I worked for a consulting firm that touted the benefits of structured content (DITA) that could be applied this way. But somehow, I think the more obvious approach of usingRead More
Creating Glossaries in DITA
Recently, I had to delve into how to create and display glossaries for DITA-based documents. One of the problems was that, while I could find information about how all of the individual pieces for a DITA glossary work, there was nothing I could find online describing how it was all put together. This article isRead More
Has DITA Plateaued?
I don’t want to seem all doom and gloom, especially after the previous post on technical writing jobs in general, but I want to talk about some interesting trends that I am seeing. And one of those is a distinct drop in job postings for technical writers with DITA experience. Right now, they account forRead More
Now is No Longer the Best Time to Be a Technical Writer Looking for a Job
Update: It’s been a couple of months since my last post, and there is now solid evidence that we are in a downturn for technical writer job postings. This is not a huge surprise, given all of the recent economic woes making the news. It also matches what I am hearing from others about variousRead More
Now is the Best Time to Be a Technical Writer (Despite a Possible Oncoming Recession)
This is the first in a series of pieces that examine trends in the technical writing job market over the past decade. Long-time readers of this blog will know I have been keeping track of technical writer job postings from Indeed.com for a while now. Indeed.com was the first job aggregator website and has beenRead More
A More Semantic Way of Describing Emphasized Inline Content in DITA 2.0
The DITA 2.0 specification is still a work in progress by the members of the OASIS DITA Technical Committee (which includes me), but it is inching ever-nearer to release. At the time of writing (early March 2022), pretty much all of the proposals for what will go into the new standard have been made, andRead More
“The Future of DITA” Presentation
Late last year I did a presentation for the Boston DITA Users Group on the Future of DITA. December 2019 doesn’t seem that long ago, but so much has changed since the coming of Covid-19. Luckily I can continue to work from home, and I hope that many of my readers are able to doRead More
DITA Sample Code: Pilot Training Manual for the Mitchell Bomber B-25
This has been a project I have been devoting time to for over the past year. It is a DITA-fied version of a full manual, in this case, a vintage, WWII-era pilot’s guide to the B-25 “Mitchell” bomber. You can find all of the DITA source files on GitHub, and there is an additional Markdown-DITARead More
The End of the Technical Writer? 2.0
For just shy of six years, I have been keeping track of the number of technical writer job postings on indeed.com—the largest job aggregator website in the United States. With the exception of a brief surge in technical writing job postings in late 2015/early 2016, there has been a steady decline in technical writer jobRead More