Key Concept Archive

AOTk: The Arbortext Open Toolkit

The AOTk is a set of plugins that will allow you to use Arbortext products directly with DITA Open Toolkit. We have everything you need to connect Arbortext with the DITA OT. We found this to be mostly an academic exercise (We did it for fun because we could): Most…

From Open Source Volunteer to Full-Time Tech Writer

In this talk, Gale describes a little bit about what open source software is and how she used her volunteer experience as an Apache Taverna committer to become a technical writer at Facebook. She describes the tangible and intangible skills she gained, as well as how she got noticed when…

Review: Adobe Technical Communications Suite 2017, UI, UX, and Techcomm

Updated: 29 November 2017 Last month I wrote about an article by Linn Vizard that I saw on the Adobe Creative Cloud blog about the Evolution of Buttons in UX Design.  While I thoroughly enjoyed the article for personal reasons, I highlighted the article because UI and UX have become…

Adding Custom Actions to OxygenXML Frameworks

Elizabeth Fraley will walk through one way to customize the OxygenXML environment. What you will learn: How custom actions can personalize your OxygenXML environment How custom actions work How to add menu items and toolbar buttons that will trigger your custom actions Save yourself time by automating repetitive tasks Where…

The Best USB Headsets for Audio and Web Conferencing

Update: October 2018 My Plantronics headset died last week and the Logitech stopped charging. I went to get another, but I can’t even find the Plantronics anymore.  Looks like I will have to find replacements. In a pinch, while I was headsetless, I tried using the Blue Yeti for calls,…

Harnessing the Chi of Swagger in Your API Docs

Frequently when tech writers start creating API documentation, a developer will ask, Why don’t we use Swagger? Swagger, or the OpenAPI specification, is an open standard for describing your REST API. The Swagger/OpenAPI spec, which is created in YAML or JSON, can be parsed by different tools, such as the…

Subscription licenses are here to stay

Updated: May 2017 The software companies of world has decided the answer to that question is yes. I first heard about subscription licenses from Adobe back in 2013. Then Microsoft followed. For good or bad, whether we like it or not, it’s here to stay. I’ve had a crash course in subscription licensing…

How to find the best content management system (or any other tool)

b Post Summary In this article, I hope I can convince you to gather requirements before you buy. It’s the only way to guarantee that you find the best content management system for you. Not for someone else. FOR YOU. Whenever you’re looking to buy more than a simple retail…

What is the best for DITA authoring and publishing tool?

I see this question posted all the time – in newsgroups, in blog comments, in LinkedIn groups. Posting this kind of question will get you one of three classes of answer. And every time, the answers posted are wrong. Most answers come from vendors posting about the tools they represent. It’s what…

Publish High-Quality, Print-Ready DITA in less than a day

b Post Summary Everyone says, “Publishing DITA is Hard!” But the truth is you can publish DITA content for ePub and Print output with very little work. The promise that vendors (like us) have been giving for 20 years is real today. I published Arbortext 101 in less than one day for…