The following is a guest post by Marcia Johnston. Marcia lives in Portland, Oregon, at the intersection of Writing, User Experience, Information Architecture, and Content Strategy. She is the president of Marcia Riefer Johnston, Inc. Marcia Johnston They has gone singular. So have their, them, and themselves. We're assailed every day by sentences like these: “What's annoying to me isn't someone using their phone at the table, it's the ...
Everything is Miscellaneous, by David Weinberger In Everything is Miscellaneous, Dave Weinberger argues that classifications that we have imposed on most everything from the alphabet to the encyclopedia, planets, books, and knowledge ultimately represent our own beliefs and priorities. As time changes, we see how our own thinking at that time inclined us to organize the information that way. In reality, things in the world don't have suc...
Letting Go of the Words (2007), by Ginny Redish, puts forward an idea that many readers will eagerly embrace: think of writing as you would a conversation. Anticipate the reader's questions as you craft your content. Redish explains, If you think of the web as conversation, you'll realize that much of your content is meant to answer the questions that people come with. you do not want an entire site to be in a section called frequently a...
During my annual performance review last week, my manager gave me a few tips to work on (as the format of the review requires). One of his suggestions was to get others to work for me. This advice (somewhat nontraditional), is something I've been mulling over for the entire week. I'm convinced that it is probably the best career advice I've ever been given. It's the first step towards scalability. First, a little background. I confess I h...
Every so often I let my blog sponsors post a message to my readers. Below are brief messages from ScreenSteps, Adobe, 3vdia, Congility, Madcap Software, and MindTouch. Read this as if you were browsing a hall of interesting vendors during a tech comm conference. ScreenSteps Desktop - Clearer Documentation in Less Time ScreenSteps Desktop is the simplest and fastest way to create clearer software documentation in less time. By integrati...
I recently spoke with Noz Urbina, consultant from Mekon Ltd, about his upcoming conference, Congility, and about content strategy. Based in Valencia, Spain, Noz is one of the industry's thought leaders on XML, DITA, component content management, and content strategy. This year he and Mekon are running a conference called Congility (formerly X-Pubs), held in Gatwick UK, May 25-26. Noz says that Congility is about making your content "agi...
I received the following question from a reader. If you would like to respond, please add your response in the comments below. I'm a college senior graduating this May with my degree in Technical Communication. Do you have any tips for an aspiring content strategist? What skills or knowledge set would I need to have to pursue a career in content strategy? I know that as technical communicators, we already possess a lot of the soft skill...
The Elements of Content Strategy (A Book Apart, 2011), by Erin Kissane, provides the most brief yet thorough treatment of content strategy that you're going to find. In about 75 pages, she lays out the principles of content strategy, traces its origins, and then outlines her methodology for doing content strategy. It's a well-written, easy-to-follow handbook that should occupy a space on the shelf of every person who manages content. The ...
Search Patterns: Design for Discovery (2010, O’Reilly), by Peter Morville and Jeffrey Callender, explores search in depth, from every possible angle. Search Patterns is a must-read for anyone interested in search and findability. It should be particularly applicable to technical communicators, who rely on search as a key method for users to locate information. The book is foundational and, though brief, highlights ten search patter...
Content Talks is a new podcast from Brain Traffic Hey podcast listeners, check out Content Talks, a new podcast by Brain Traffic on content strategy. The first episode features Kristina Halverson interviewing Ann Rockley about content strategy issues. It's a great interview, and Ann sounds lively and engaged. Kristina steers Ann towards detailed stories and experiences as they make their way through a host of content issues. Kristina says...
After I wrote my post exploring alternative classification schemes, I was flipping through a hymnbook and noticed there are seven different methods of classification for the hymns: Authors and Composers Titles, Tunes, and Meters Tune Names Meters Scriptures Topics First Lines and Titles [gallery] How cool is that. Some of those classifications are obviously geared towards organists. And these classifications are tucked away in the back...
At the upcoming STC Summit in Sacramento, I'm presenting a session titled Organizing Help Content: Breaking Out of Topic-Based Hierarchies. The title is a bit wordy. It's basically information architecture applied to help content. Or even simpler, making help content findable. In this post, I'll give you a sneak peak at what this presentation is all about. One of the biggest challenges technical writers face is enabling users to find the ...
Listen here: A Practical Guide to Information Architecture Donna Spencer is the author of A Practical Guide to Information Architecture as well as two other books (on card sorting and writing for the web). She's an experienced information architect, based in Australia, who gives regular workshops on information architecture at conferences such as the IA Summit and also runs the UX Australia conference. In this podcast ...
My colleague Ben Minson wrote a post about why tripane help is a relic of the book-paradigm documentation age, and how it can limit us from taking advantage of other web technologies. See Why I Don't Like Tri-pane Help. As a quick definition, tripane help is the standard webhelp HTML output that has several frames -- the table of contents pane on the left, the main topic area in the middle, and a pane across the top. For example, here's a...
Listen here: Visual Composing: Document Design for Print and Digital Media Recently Jo Mackiewicz (Auburn University) and Kathryn Riley (Illinois Institute of Technology) published Visual Composing: Document Design for Print and Digital Media with Pearson. This book covers the visual side of document design, including all the design decisions from the font you use to the colors you choose to the tables, column widths, im...