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
Category: Articles
Feature articles by DITAWriter or by other contributors.
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
DITAWriter’s Lightweight DITA Code Samples
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
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