I recently gave a presentation to the Southwestern Ontario STC chapter called Organizing Help Content: Breaking Out of Topic-Based Hierarchies.  Here’s a recording of the presentation: Webinar recording Slides only Audio only

One of the findability features in our help systems that we often overlook is the breadcrumb. Breadcrumbs typically sit above the page title and highlight the hierarchical path that leads to where you are. Here’s a screenshot of a typical breadcrumb, taken from Adobe Illustrator’s help: Greg Nudelman discusses breadcrumbs in one of his chapters in Designing Search: UX Strategies for eCommerce Success. This post … more »

I recently read Tagging: People-Powered Metadata for the Social Web (2008), by Gene Smith. Smith dives into tagging as a method for adding metadata to resources, which in turn increases the organization and findability of the resources. Traditional help authoring tools categorize resources through folders (a carryover from Windows folders), whereas web platforms typically use tags. Tags are actually a quick and easy way to attach metadata … more »

Here are my slides from the STC webinar I presented on organizing content (findability). The official title of the webinar was “Organizing Content: Breaking Out of Topic-Based Hierarchies.”  I added detailed notes for each slide. This should make the presentation understandable even without the audio recording. You can download the presentation in two formats: PDF format PowerPoint format Feb 19, 2012 update:You can listen to the … more »

I’m giving an STC webinar this Thursday. Here’s the description: Organizing Help Content: Breaking Out of Topic-Based Hierarchies Organizing help content so that users can both find and learn information often requires technical writers to break out of the traditional topic-based folders and move toward faceted navigation, search engine optimization, interface text, level-based help, and other methods for organizing content. In theory, this is the … more »

The recording is available in a variety of formats: Audio with Slides MP3 Audio Only PowerPoint Show File PowerPoint Original File iPod format I recently gave a presentation at the STC Summit in Sacramento titled “Organizing Help Content: Breaking Out of Topic-based Hierarchies.” I would have recorded my presentation, but recording is not allowed. I did, however, record a practice run-through in my hotel room … more »

The following is a guest post by Mark Baker. The a-ha moment came for me reading David Weinberger’s Everything is Miscellaneous, a book Tom and I both admire. Weinberger’s central thesis is that miscellany has become more powerful than order. No one ordering of information is ideal for every reader. The web allows readers to find information for themselves, and to organize it for themselves … more »

[amazon-product align="right" alink="#082ef6" height="250" region="us" tracking_id="idrabewr-20"]0596802277[/amazon-product] 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, … more »

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 … more »

[Audio clip: view full post to listen] Download MP3 Length: 40 min. 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 … more »

I was talking to a colleague today about wikis when he mentioned Google, and how Google has such a brilliantly simple solution that allows users to find content. With Google, there’s a search box. The users type keywords they want information about, and most of the time Google returns brilliantly relevant results. While some credit is certainly due to Google’s Pagerank algorithm, what enables findability … more »

Last year I started a series on organizing content that spanned nearly 30 posts. I want to return to this thread with a summary of why findability becomes an issue for technical writers, and what the information paradox is that we encounter. Then, in an usual ethical twist, I’ll explain why findability might not actually be an issue. The Documentation Scenario The help scenario starts … more »

In a previous comment, Larry Kunz wondered if the semantic web might be useful in helping users find the content they’re looking for. I decided to ask Patrick Warren to write a guest post on the semantic web based on questions I asked him. There’s a lot of material to ingest and think about in Patrick’s responses. It definitely get the ball rolling in a … more »

In my last post, I argued that navigation systems can’t be entirely discarded in favor of search, because navigation helps users discover the unknown unknown. But now that we’ve covered navigation systems a bit, it’s time to move on to search, because search is undoubtedly a major way that users navigate help content. How can you organize your content so that the topics are findable … more »

[Audio clip: view full post to listen] Download MP3 Length: 25 min. The sixth sin in my ongoing series on the Seven Deadly Sins of Blogging is being unfindable. (The other sins include being fake, irrelevant, boring, unreadable, irresponsible, and inattentive). Admittedly, lack of findability seems more a sin of omission than commission. Being unfindable seems like a sin bloggers commit against themselves. I’ve written … more »