An index helps users to find the information they need in the documentation that you write. A good index records every pertinent statement in the body of the text. The subject matter and purpose of each section in your book determine which statements are pertinent and which are peripheral. Deciding which statements are pertinent is a judgment call, and the task that causes most difficulty for writers. These guidelines help you to recognize and label statements for an index.
Consider the following points when you look for pertinent statements to index:
Statements that refer to the following topics are often pertinent for an index:
When you identify a pertinent statement, you need to flag the statement in a way that alerts the user to the information. This flag is the index entry. When you compose an index entry, you must first determine the topics that relate to the statement. These topics become the primary entries. Next, you must determine the nature of the information in the statement relating to each topic. These descriptions become the secondary entries.
Make your primary entries precise, logical, and consistent with the terminology in the rest of the documentation set. Some tips:
Make your primary entries nouns or a noun phrase that a user might look for. For example:
| Applications | Noun. |
| Starting applications | Noun phrase. |
Do not use verbs or adjectives standing alone, because users are unlikely to search for these words.
Make sure that the term used for the primary entry appears on the page to which the index points.
A subentry is a verb, phrase, or adjective that describes the nature of the information about a topic. You can also use nouns and noun phrases for subentries. For example:
menu
starting from menu
starting from command line
See the http://developer.gnome.org/projects/gdp/handbook.html, Indexing for more examples of index subentries.
You can use the following types of cross-references to help users to navigate the index:
Use this cross-reference to point from a synonym to the term under which the user can find the index entries.
Use this cross-reference to point the user to topics that are related to the original entry.