ABSTRACT
This paper discusses various scenarios encountered by visitors using search for a large documentation library. It identifies potential problems arising from the users' level of understanding of the documentation and the search system. It proposes solutions to these problems, some of which are common to other search systems, and others that may be specific to this type of documentation and audience.The paper then considers ways in which the documentation can be organized and written to make choices easier for searchers. It presents examples of popular destinations and typical navigation paths, illustrating how users sometimes find what they want, and other times find it difficult to make a choice or end up in the wrong place.In particular, it explores nontraditional techniques such as:
Guiding users to "jumping off" points, where they can perform searches using predefined terms and search options.
Identifying and recovering from specific search errors made by frequent users, as opposed to isolated, individual errors.
Rewording headings to persuade or dissuade searchers as appropriate. Some headings are made more emphatic, others are intentionally made more vague.
- Russell, John. Who Are You, and Where Did You Come From? IEEE Professional Communication Society, October 2001.Google Scholar
- Andersen, Jakob. Microcontent: How to Write Headlines, Page Titles, and Subject Lines. Alertbox, September 1998. http://www.useit.com/alertbox/980906.htmlGoogle Scholar
Index Terms
- Find what I mean: exploring new kinds of search results
Recommendations
On Search Powered Navigation
ICTIR '17: Proceedings of the ACM SIGIR International Conference on Theory of Information Retrievalmain components of exploratory search. Search lets users dig in deep by controlling their actions to focus on and find just the information they need, whereas navigation helps them to get an overview to decide which content is most important. In this ...
Creating a massive master index for HTML and print
SIGDOC '02: Proceedings of the 20th annual international conference on Computer documentationAn index connects readers with information. Creating an index for a single book is a time-honored craft. Creating an index for a massive library of HTML topics is a modern craft that has largely been discarded in favor of robust search engines. The ...
Spotter: towards a unified search interface in IDEs
SPLASH Companion 2015: Companion Proceedings of the 2015 ACM SIGPLAN International Conference on Systems, Programming, Languages and Applications: Software for HumanityProgram comprehension requires developers to reason about many kinds of highly interconnected software entities. Dealing with this reality prompts developers to continuously intertwine searching and navigation. Nevertheless, most integrated development ...
Comments