Key Concept Archive

For more information about how our library science background (and our love of all things metadata) guides the way we catalog information, see the Techcomm and Arbortext Resources page.

Want to see what kind of software docs engineers celebrate?

I see posts on LinkedIn all the time about training in writing API docs or how best to document software systems. Here in Silicon Valley, it’s the hottest sub-discipline in techcomm. In fact, API docs are so popular, they have an API Docs training class on the day before TC Camp in…

12 tips from UX designers that Techcomm folks should know too

Next to API docs, UI/UX is one of the fastest growing sub-domains in technical writing. Not surprising, because documentation contributes to the user experience and explain how to use a product’s user interface.In May, I spotted an article by Robert Hoekman, Jr. that I’ve now read several times. He called it…

Tell a good story (It’s the shape of the curve that matters)

Seems like everyone is talking about story telling. Last April, it was the theme at the STC Spectrum conference.  At STC Summit in 2015, Nancy Duarte gave the keynote based on research she did for her book, “Resonate: Present Visual Stories that Transform Audiences,” on the way great speechwriters use emotional trajectory…

Paper or ePub?

Did you know that reading on a kindle or other electronic device isn’t the same to your brain as reading on paper? Well, as it turns out: Neuroscience, in fact, has revealed that humans use different parts of the brain when reading from a piece of paper or from a…

Conference notes from: World IA Day 2016

Last month I went to World IA Day 2016 in Seattle. I’m based in San Francisco, which also hosted World IA Day event, but every now and again it’s good to get out of your little corner of the world and see what is going on elsewhere. I have a very…

Inclusive vs Exclusive Language and Corporate Culture

It seems that as of 6/5/2019, the GSA has pulled the article down. Good thing we captured what we did! The U.S. General Services Administration (GSA.gov) website recently published an article about how they customized a Slack bot to gently correct people who use the word “guys”.The GSA has a big…

Metadata and Taxonomy Workshop for DITA Authoring Teams

Working in DITA will lead to having a large library of content units that has a high potential for reuse across product information as well as business documentation that supports operational effectivity. As the Technical publications departments plan the move to structured authoring, several concerns arise about how to address…

Common Questions: Change Markup

This week’s topic: Change Tracking & Change Markup Change markup has historically been something that you had to implement yourself in XML publishing. Arbortext supports typical change markup behavior in the standard document types, and with a small amount of configuration for custom doctypes. All of the standard change markup…