Feature articles by DITAWriter or by other contributors.
At the conclusion of my previous article on working with the Claude AI, I said that I planned to continue the work of converting legacy content to DITA using AI to see if there was anything else I could learn from the experience. I have just finished posting a newly DITA-fied Model T car manualRead More
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
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
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
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
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
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
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
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
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
