+1 408 660-3219 sales@single-sourcing.com

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.

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…

Style Guides: Fashionable But Also Practical

Having problems with inconsistently written documentation? Do your user manuals need some help themselves? If so, then you need a style guide for your technical writing team. We’re not talking about what they should wear, but how they should write….

How many books did you read last year?

Late last year, I saw an article in the Atlantic that talked about the Decline of the American Book Lover.The Pew Research Center reported last week that nearly a quarter of American adults had not read a single book in the past…

Get your [bleep] together…with DITA maps

In this TC Dojo session, we’ll talk about maps, maps, and more maps. Using maps to organize your thoughts, your keys, your content, your deliverables. We’ll talk about mini-maps and deliverable maps, and why you should not use bookmaps (unless…

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…

Editing the Work of Non-Native English Speakers

As content ninjas in a global environment, editors often get asked to improve content created by non-native English speakers. While it can be challenging to edit this type of content, knowing the common mistakes can help you be more efficient…