Top Tips on Writing an Index for Your Paper

How to Write an Index for Your Paper?

Creating an accurate index for a technical paper can be daunting, especially for someone new to technical writing.

In truth, it is commonplace not to include an index in an online help file. Instead, there is more reliance on search engine functionality. However, in some cases, for certain audiences and clearly in print-version documents, a well-compiled index is an invaluable – and often indispensable - feature.  

Take, for instance, someone who documents some type of enterprise or business application. This can include countless code tables, including code for customization with the fields displayed on the computer screen, various invoice types, and a range of email-able and/or printable documents accessible to users through different parts of a particular system. When users need help on any given code table, it may be possible for them to look it up by its name, or if the precise name is not known, it may be possible to browse the system’s index while searching for, for example, every code table beginning with “F1.” Finding information would be much more difficult if such an index did not exist.   

It is easy to forget how much people depend on search files and accurate indexes, especially when buying an eBook or a technical guide. Say, for example, you want to learn CSS. Finding a Kindle version of a book you are looking for can be exciting since this is a quick way of obtaining information.

Indeed, you may even think that eBooks are a great way of freeing up bookshelf space - or at least clearing shelves currently packed with reference and fact-checking books. However, it can be disappointing that the publisher’s program for PCs does not have a search and that the index for a particular book might just be a list of hundreds of words with no page numbers or links.

This annoyance may even prompt you to email the publisher’s support team to express your disappointment. If you are lucky, the publisher might update their system to include a search feature, but they might not.

Ways for Creating an Index

In an ideal world, one of the best and fastest ways to create an index is to look for an indexer you could hire, i.e., a person who earns a living creating indexes. Indeed, most good indexers are never happier than when tasked with creating a comprehensive, well-structured index. However, people often do not have enough time or money to hire an indexer, and you - the writer – must create your index. If you have never created an index before, the following are a few useful tips to get you started: 

1. Begin by marking out the main headings for your topic. Include one index entry or more for each heading. Remember to consider capitalization. As a rule, lowercase letters should be used except for proper nouns. This system is a good starting point for the first round through the document you want to index.
2. Consider any additional words or word combinations that users will likely search under to find particular topics. Review your topic’s main headings again and think about what additional words a user might associate with this topic. If, for instance, a topic is about rebooting a computer, you may want to add a further entry under the term “restart” for people who may be familiar with this particular term.
3. Try looking for keywords in every topic. Go through every topic to select keywords that users might use in their searches. This could include the title (or name) of menus, windows, dialog boxes, or less familiar terms for any topic that has a definition of the applicable term included.
4. See if you can develop synonyms for keywords. Look for synonyms for any keywords you selected in the last round. Think about your users and the terms that might be better known to them.
5. Do some brainstorming to find additional words that users might use in their search. Consider the product you have been writing about, and then brainstorm to see if you can come up with any additional words that users might search under.
6. Read back over your index when you have completed it. As is the case with all types of writing, ensure you read back over your index once you have created it, checking carefully for typos and spelling mistakes.