Index area layout

Print topic Print topic Previous topic  Next topic

Most help authoring tools create a well-designed index automatically.

If you create a compiled help format, usually there aren’t any customization options.

If you create browser-based help (plain HTML), the only thing that you usually need to do is to customize fonts and colors.

The key elements of the index area are:

a search box where users can enter the first letters of the term to search for; alternatively, a list of letters with links that take users to the places where the index entries for each letter start

subheadings for each letter

index entries

index subentries

Expand /Collapse All Subsections

Design tips and examples

When possible, put the search box or the links into a non-scrolling region so that they remain in place when users scroll down within the index.

If you add letters and links, omit those letters in the index for which there’s no entry.

If space is limited, use a narrow font. If you use Verdana for the topic text, Arial is a good choice for the index entries. Use the same font size as for the topic text.

Within the list of index entries, make the subheadings for each letter visually prominent so that readers can identify each section clearly even while scrolling. Use bold font style and an increased space before the paragraph. Indent subentries.

The following picture contrasts some different implementations:

 

Synchronization with the table of contents

If your authoring tool supports it, activate synchronization with the table of contents so that when a user clicks an index entry the corresponding topic is also highlighted in the table of contents.


Recommended screen layouts

Structuring: Standard sections in software user assistance

Structuring: Alphabetical index