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.

Topic Writing Without Borders

The average person is hit with approximately 105,000 words a day. That’s 23 words every second in a twelve-hour day. Add in images and sound, and now we’re talking 34 gigabytes a day! This is the person who comes to…

Using Confluence for External Facing Product Documentation

As a Technical Communicator, we all get this question: What tool do you use to write your technical documentation? Romy has found that her answer surprises most people, who then immediately want to know how they use it and if…

How to Identify DITA Topic Types (like a ninja)

When you’re new to DITA everything seems hard. Even choosing a topic type. New writers lean away from the specialized toward the generic. Teams get inconsistent structures for similar information across deliverables. In this session, Liz Fraley will show you…

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…

Tips for writing great documentation

I recently read a great article by Taylor Singletary who’s been writing documentation for customer facing products that almost all of us use: LinkedIn, Twitter, and Slack. If you ask him, he says he works in “developer relations.” He wrote up…

Life with Guru D: Adopting a DITA Mindset and Converting Others

DITA methodology is often difficult for people to grasp. It does require a complete shift in how you view and author your content. You can’t take a book and shove it over. It doesn’t work like that. You need to…

Conference notes from: DITA Best Practices BOF lunch at CMS DITA NA 2015

Tracy Baker and I had a full table and intense discussion on the topics on the minds of the people in attendance. Real time issues and ideas for possible solutions. Topics ranged from reuse strategies to getting started to review processes to getting…

Information Architecture Bottom-Up

The advent of electronic media and particularly the Web has profoundly changed how people seek and use information. Information seeking today is dominated by search, and not by search of individual works, but search of the whole: whole sites, whole…