---
title: "Implementing Faceted Classification/Search with a Help Authoring Tool [Organizing Content 7]"
date: 2010-05-21
description: "Findability / organizing content 1.0 New Series: Organizing Content [Organizing Content 1] 1.2 Introducing Project..."
canonical_url: https://idratherbewriting.com/2010/05/21/implementing-faceted-classificationsearch-with-a-help-authoring-tool-organizing-content-7/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# Implementing Faceted Classification/Search with a Help Authoring Tool [Organizing Content 7]

1. [1.0 New Series: Organizing Content [Organizing Content 1]](https://idratherbewriting.com/2010/05/17/new-series-organizing-content-organizing-content-1/)
2. [1.2 Introducing Project Swordfish [Organizing Content 2]](https://idratherbewriting.com/2010/05/17/introducing-project-swordfish-organizing-content-2/)
3. [1.3 Things Fall Apart, The Centre Cannot Hold [Organizing Content 3]](https://idratherbewriting.com/2010/05/17/things-fall-apart-the-centre-cannot-hold-organizing-content-3/)
4. [1.4 Imposing Order Versus Observing Order [Organizing Content 4]](https://idratherbewriting.com/2010/05/18/imposing-order-versus-observing-order-organizing-content-4/)
5. [1.5 Topic-Based, Hierarchical Navigation [Organizing Content 5]](https://idratherbewriting.com/2010/05/19/topic-based-hierarchical-navigation-organizing-content-5/)
6. [1.55 25 Facets for Navigation [Organizing Content 5]](https://idratherbewriting.com/2010/05/17/25-facets-for-navigation-organizing-content-5/)
7. [1.6 Faceted Classification, Faceted Search [Organizing Content 6]](https://idratherbewriting.com/2010/05/20/faceted-classification-faceted-search-organizing-content-6/)
8. 1.7 → Implementing Faceted Classification/Search with a Help Authoring Tool [Organizing Content 7]
9. [1.8 Second-Level Faceted Navigation [Organizing Content 8]](https://idratherbewriting.com/2010/05/25/second-level-faceted-navigation-organizing-content-8/)
10. [1.9 Browse Versus Search: Stumbling into the Unknown Unknown [Organizing Content 9]](https://idratherbewriting.com/2010/05/26/browse-versus-search-organizing-content-9/)
11. [2.0 Figuring Out Search Algorithms [Organizing Content 10]](https://idratherbewriting.com/2010/05/27/figuring-out-search-algorithms-organizing-content-10/)
12. [2.1 Search Engine Optimizing Your Help Content for Google [Organizing Content 11]](https://idratherbewriting.com/2010/05/28/search-engine-optimizing-your-help-content-for-google-organizing-content-10/)
13. [2.2 From Help Authoring Tools to Web Tools, Especially Wikis [Organizing Content 12]](https://idratherbewriting.com/2010/06/03/from-help-authoring-tools-to-web-tools-especially-wikis-organizing-content-12/)
14. [2.3 Using Mediawiki Templates to Organize Content [Organizing Content 13]](https://idratherbewriting.com/2010/06/09/using-mediawiki-templates-to-organize-content-organizing-content-13/)
15. [2.4 The Semantic Web and Content Findability: Interview with Patrick Warren [Organizing Content 14]](https://idratherbewriting.com/2010/06/10/the-semantic-web-and-content-findability-interview-with-patrick-warrant-organizing-content-14/)
16. [2.5 Faulty Assumptions About the Scope of Help Content? [Organizing Content 15]](https://idratherbewriting.com/2010/06/11/faulty-assumptions-about-the-scope-of-help-content-organizing-content-1/)
17. [2.6 Can Blogs Work as a Web Platform for Help? [Organizing Content 16]](https://idratherbewriting.com/2010/06/23/can-blogs-work-as-a-web-platform-for-help-organizing-content-16/)
18. [2.7 Organizing Content as Story [Organizing Content #17]](https://idratherbewriting.com/2010/06/29/organizing-content-as-story-organizing-content-17/)
19. [2.8 Separating Basic from Advanced Topics: How Twitter Organizes Their Help [Organizing Content #18]](https://idratherbewriting.com/2010/07/08/separating-basic-from-advanced-topics-how-twitter-organizes-their-help-organizing-content-18/)
20. [2.9 Emergence [Organizing Content #19]](https://idratherbewriting.com/2010/07/20/emergence-organizing-content-19/)
21. [3.0 Relying on the Wisdom of the Crowds with Help Authoring [Organizing Content #20]](https://idratherbewriting.com/2010/07/27/relying-on-the-wisdom-of-the-crowds-with-help-authoring-organizing-content-20/)
22. [3.1 Principles for Organizing Print Material [Organizing Content #21]](https://idratherbewriting.com/2010/07/30/principles-for-organizing-print-material-organizing-content-21/)
23. [3.2 The Technical Writer as an Outsider: How Ambitious Are You? [Organizing Content #22]](https://idratherbewriting.com/2010/08/06/the-technical-writer-as-an-outsider-how-ambitious-are-you/)
24. [3.3 The Interface Is Text [Organizing Content #23]](https://idratherbewriting.com/2010/08/11/the-interface-is-text-organizing-content-23/)
25. [3.4 Best Practices for Writing Interface Text [Organizing Content #24]](https://idratherbewriting.com/2010/08/13/best-practices-for-writing-interface-text-organizing-content-24/)
26. [3.5 Organizing for Learnability [Organizing Content #25]](https://idratherbewriting.com/2010/09/01/organizing-for-learnability-organizing-content-25/)
27. [3.6 Why Learning Software Is So Hard, and Organizing Content into Levels [Organizing Content #26]](https://idratherbewriting.com/2010/09/09/why-learning-software-is-so-hard-and-organizing-content-into-levels-organizing-content-26/)
28. [3.7 Is Rhetoric Relevant? Considering the "Message in Context" [Organizing Content #27]](https://idratherbewriting.com/2010/09/22/whence-rhetoric/)
29. [3.8 Organizing Content for Constructivist Learning [Organizing Content #28]](https://idratherbewriting.com/2010/09/27/organizing-content-for-constructivist-learning-organizing-content-28/)
30. [3.9 Eight Defining Questions that Shape Content Organization [Organizing Content #29]](https://idratherbewriting.com/2010/10/01/eight-defining-questions-that-shape-content-organization-organizing-content-29/)
31. [4.0 Why Help Content Fails and #contentstrategy](https://idratherbewriting.com/2010/10/22/why-help-content-fails-contentstrategy/)

In my [last post](https://idratherbewriting.com/2010/05/20/faceted-classification-faceted-search-organizing-content-6/), I presented faceted classification and faceted search as an alternative method of organization for help content. While faceted navigation systems are common on the web, implementing a faceted navigation system to describe help content using one of the common help authoring tools, such as Flare, RoboHelp, Author-It, Doc-to-Help, is more challenging.

### Faceted Browsing

According to Tony Self, one of the strengths of a help authoring tool (HAT) is the table of contents (TOC) feature. Through the TOC, you can easily create a quick system of navigation.

It's common to use this TOC to create a system of topic-based containers for users to navigate, but there's no reason why you couldn't instead dedicate the folders to facets. In the prototype below, each of the "Browse by ... " books in the left pane represents the facets by which users can navigate the help content.

![Faceted browsing system showing alternative methods of navigation](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/agent_browsingfacet21.png)

Users can browse the content by the following facets:

- **Browse by Topic.** Topics are arranged in the traditional topic-based, hierarchical containers.
- **Browse by Role.** Topics are arranged by role (super agent and regular agent), and then broken down by topic containers.
- **Browse by Skill Level.** Topics are broken into two books, Advanced and Beginner. And then most likely broken down by topic containers.
- **Browse by Popularity.**Only the top 20 most popular topics are listed.
- **Browse by Concept or Task.**Topics are divided into concept and task groupings, and then probably broken down by topic containers.
- **Browse by Status.**Topics are organized by facet. (In Swordfish, statuses play a prominent role for operations. Depending on the status of the operation, you can perform certain tasks, so this provides a way to organize the tasks.)
- **Browse by Help Format.** Topics are divided into video, diagram, and FAQ groupings.
- **Browse by Problem.**Topics are arranged by problem, somewhat like a troubleshooting grid.
- **Browse by Screen**. Topics are arranged by screen. These are the context-sensitive help topics.

Almost every HAT allows you to create multiple TOCs. Each of these facets is simply a secondary TOC that is integrated into the master TOC.

One of the problems with these facets is that they don't entirely get away from the topic-based containers that I am resisting. With 200 topics, I can't simply divide all topics in the help into two groupings, such as Advanced and Beginner. A second tier facet is also necessary, and the only second-tier facet that makes sense is the topic container.

However, some inclusion of topic containers isn't necessarily a bad thing. The main reason topic containers fail is because of the abundance of topics. In small help systems, the topic containers provide easy navigation and aren't as frustrating for users. The first facet, such as Advanced or Beginner, breaks down this large number of topics into a smaller subset, which makes the navigation more feasible.

### Faceted Search

When a user clicks the search tab and searches for an item, the user can narrow the search results by using similar facets, as shown in the following image.

![Faceted Search](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/agent_searchfacet21.png)

I'm not sure how it would be implemented in other HATs, but in Madcap Flare, you can tag each topic with a keyword (this is called inserting Concepts). You can then add this set of tags/concepts below the search box by adding a "Search Filter Set" to your help.

The challenge here is to provide the same facets that users get by browsing. Tags work a bit differently than TOCs, but the idea is the same. You can limit the search results by the following:

- Regular Agent Role
- Super Agent Role
- Advanced Level
- Beginner Level
- Conceptual Topics
- Step-by-Step Topics
- Most Asked About
- Video Format
- Diagram Format
- FAQ Topic

Not all of the TOC facets end up as tags. The Browse by Role facet has two roles, so I can tag topics within these books as either a Regular Agent Role or Super Agent Role.

The Browse by Skill Level facet has two levels, Beginner and Advanced, so I can tag the topics within this facet as Beginner Level or Advanced Level.

For the Browse by Concept or Task facet, I can tag the topics as Conceptual Topics or Step-by-Step Topics.

The Browse by Popularity is tagged as Most Asked About (or Most Popular).

Finally, the Browse by Format allows me to tag the topics as Video Format, Diagram Format, or FAQ topic (these are the only three main formats in the help material apart from the concept/task distinction).

### Shortcomings of Faceted Search

One of the most difficult problems with setting up faceted navigation is to identify facets for information topics. With merchandise or other products, you can often identify a clear set of attributes that define the product. With shoes, you can classify and filter the shoes by brand, style, color, cost, gender, sport, size, and other qualities.

With Google, you can classify the content by a plethora of information formats, including news, books, videos, images, maps, discussions, shopping, blogs, twitter ("updates"), and more.

In a library, you can classify books by author, publication date, genre, period, subject, book type, etc.

Help topics don't seem to have a set of clearly identifiable facets. Some of the facets that you could classify a help topic with -- for example, length, format, reading level, information type, corresponding screen, etc. -- aren't that helpful to users.

Help content is, however, rich in topics. But using topic tags as the attributes seems like the same game as the topic-based, hierarchical containers. For example, look at the faceted search filters that I've circled in the following image.

![Topic facets on a search for a topic seem redundant and confusing to me](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/agent_searchfacet_toomany11.png)

*Topic facets on a search for a topic*

If a user searches the help for "run a black operations campaign," what benefit is there in limiting the results to the facet "Related to black ops"? Won't the results already contain black ops topics?

Further, what if a user searches for "coordinate informants for black ops"? Which facet would I then choose to limit the results -- *Related to Black Ops* or *Related to Informants*? It's the same problem as the topic-based, hierarchical containers.

Searching for a topic and then limiting the results by topics seems redundant to me.

Moreover, if these facets are simply topics, there's a likely chance that you'll include dozens of topics. Adding too many topics in the Search Filter Set will bloat the number of search facets beyond what is usable. If you look at the [search filter set in Flare's online help](http://webhelp.madcapsoftware.com/flare6/), you'll see that they use about 80 different topics in their search filter set, which seems excessive.

It's clear that faceted classification and faceted search have benefits for many product websites, as well as for many information-heavy websites with many types of content. But the lack of a clear set of facets for help material makes it more challenging to implement in a way that is clearly beneficial.