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.

Get Trained on Arbortext Styler — from someone who cares about you

We’re launching a series of online training sessions designed to facilitate better Stylesheet design using Arbortext Styler. Why? Well, if you saw my outburst on Facebook, you can probably guess the reason. Sadly, this kind of thing happens to us…

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…

Same mess, different tools – Liz Fraley on the Content Content Podcast

In her interview, Liz Fraley talks in detail about the history of structured authoring and how her opinions have changed over 17 years in the technical writing industry. Last month I had the opportunity to talk with Ed Marsh of…

Topic Based Writing: Future-Proofing Your Content?

This is what we’ll cover: Topic-Based writing: the basics The nature of a topic Topic morphology: title, short description (optionally) and content The importance of conceptual consistency Topic-Based writing: content creation and management Standing alone versus story telling A theory…

Teaching Martians to make a sandwich–How Technical Writers can improve patient safety

There’s a well-known exercise to experienced technical writers: How do you teach a Martian to make a sandwich. It’s so well known that we talk about it as an exercise in best practices for user experience and modern instructional design….

Writing (Non-Agile) Business Requirements

Writing requirements requires the ability to write clearly, concisely, and succinctly so others can design, develop, and test the product. This session covers 8 characteristics of writing a good requirement, reviews 4 steps to requirements gathering, and concludes with 17…

Do you treat your career like a profession?

b Post Summary There’s only you to hold you accountable, to make sure you meet your business and revenue goals. You can apply the same skills business owners, consultants, and executives use to advance their business to advance your career….

Minimalist Writing for Maximum Communication

The information age is also the age of the short attention span. We typically write for people who must spend much of each day reading. Many readers would prefer a pill that puts the information in their brain. We can’t…