Difference between revisions of "Document glossary"
(→Applicable rules) |
|||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | A [[ | + | A [[document glossary]] (hereinafter, the ''Glossary'') is a list of key terms discussed in a [[report]] or another [[document]] with their definitions. The ''Glossary'' is a conditional part of document's back or, rarely, but possibly, front matter; it is included if the document incorporates terms unfamiliar to the intended audience. When the ''Glossary'' is included, it functions as a part of document's [[structural metadata]]. |
==Description== | ==Description== | ||
The [[ANSI/NISO Scientific and Technical Reports]] standard details, | The [[ANSI/NISO Scientific and Technical Reports]] standard details, | ||
| + | :A conditional section, the glossary is a list of terms defined and explained to facilitate a reader's comprehension of the report when numerous terms requiring definition are used. | ||
| − | Glossary | + | :The glossary is part of the back matter, and glossary terms may also be defined at their first mention. Glossary terms are arranged in alphabetical order with each on a separate line followed by its definition. The glossary section, titled "Glossary," begins on a new page in print publications. Some organizations may include this section as part of the front matter to ensure that the reader is quickly aware of its existence. |
| − | + | ==Applicable rules== | |
| − | + | According to the [[ANSI/NISO Scientific and Technical Reports]] standard, | |
| − | + | :Arrange glossary entries in alphabetical order and align them with the left margin. Uniformly indent subsequent lines or maintain flush left with the left margin and enter a blank line between glossary entries. Begin each definition with a capital letter and end it with a period. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Latest revision as of 14:26, 16 November 2020
A document glossary (hereinafter, the Glossary) is a list of key terms discussed in a report or another document with their definitions. The Glossary is a conditional part of document's back or, rarely, but possibly, front matter; it is included if the document incorporates terms unfamiliar to the intended audience. When the Glossary is included, it functions as a part of document's structural metadata.
Description
The ANSI/NISO Scientific and Technical Reports standard details,
- A conditional section, the glossary is a list of terms defined and explained to facilitate a reader's comprehension of the report when numerous terms requiring definition are used.
- The glossary is part of the back matter, and glossary terms may also be defined at their first mention. Glossary terms are arranged in alphabetical order with each on a separate line followed by its definition. The glossary section, titled "Glossary," begins on a new page in print publications. Some organizations may include this section as part of the front matter to ensure that the reader is quickly aware of its existence.
Applicable rules
According to the ANSI/NISO Scientific and Technical Reports standard,
- Arrange glossary entries in alphabetical order and align them with the left margin. Uniformly indent subsequent lines or maintain flush left with the left margin and enter a blank line between glossary entries. Begin each definition with a capital letter and end it with a period.
