Difference between revisions of "Document glossary"

From CNM Wiki
Jump to: navigation, search
(Applicable rules)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
A [[report cover]] (hereinafter, the ''Cover'') is the the front and back of a [[report]]. The ''Cover'' is an optional part of report's front matter; when the ''Cover'' is included, it functions as a part of report's [[descriptive metadata]].
+
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.
  
A conditional section, the glossary is a list of terms defined and explained to facilitate a
+
==Applicable rules==
reader’s comprehension of the report when numerous terms requiring definition are used.  
+
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.
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.
 

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.