Sunday Nov 28, 2021

Learn technical writing: definition of appendix, bibliography and glossary

Three common elements in books, especially instruction books, are the appendix, the bibliography, and the glossary. This week, we will put them in their places.

Appendix

Typically, the appendix contains reference material that may be important to the reader, but due to the amount of content, it would disrupt the flow if it were included in the text. It can also contain forms or illustrations that relate to more chapters or modules. In many cases, material that some people may find useful and others irrelevant are included in an appendix.

Appendices (or appendices) are also frequently used to provide specific information at the end of RFQs and RFPs. Some examples are budget details, technical specifications, and legal elements. They are usually found at the back of the book, opposite the index.

Bibliography

A bibliography is simply a list of books, articles, web pages, or other sources that are referenced or cited in a document. They are usually found in the back of the book, before the table of contents. There are various styles and formats used for bibliographies. It is important to use the one designated by the customer.

Glossary

Glossaries are something like dictionaries dedicated to a specific subject area; an alphabetical list of terms with definitions and explanations of use.

They can be stand-alone documents, such as a glossary of computer terms, and are often included in a document when a large number of unfamiliar terms are used. They can be simple or extensive depending on the perceived needs of the target audience. They can be located at the front of a document, after the table of contents, and at the front or end of the index, usually before a bibliography or an appendix. The exact location will depend on the client’s style guide.

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to Top