Difference between revisions of "Document index"

From CNM Wiki
Jump to: navigation, search
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
A [[report index]] (hereinafter, the ''Index'') is an alphabetical listing of items and their location in a [[report]]. The ''Index'' is an optional part of report's back matter; when the ''Cover'' is included, it functions as a part of report's [[descriptive metadata]].
+
A [[document index]] (hereinafter, the ''Index'') is an alphabetical listing of discussed concepts, topics, and items and their location in a [[report]] or another [[document]]. The ''Index'' is a conditional part of report's back matter; it is included when a user may need to locate all references to a concept, topic, and/or item. When the ''Index'' 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,
 +
:An index is an alphabetical listing of all major topics discussed in a report. An index is optional in short reports (fewer than 50 print pages), but reports of 50 pages or more usually contain one to help readers locate specific information. An index entry cites the page or location where the topic can be found, affording readers quick reference on a particular topic. An index may identify and locate information, indicate its nature and scope, identify related entries, and clarify relationships between entries. The arrangement and level of detail of the index are determined by the structure of the report, its target audience, and its anticipated uses.
  
Index
+
:The most common type of index for a report is the subject index in which subjects are presented alphabetically. Other types of indexes (for example, name index, number, and code index) may also be used. They are placed before the subject index in the back matter.
  
An index is an alphabetical listing of all major topics discussed in a report. An index is
+
:In preparing an index, the number and kind of access points (entry locations) and the information level of indexable matter (for example, abstract or concrete) are determined.  
optional in short reports (fewer than 50 print pages), but reports of 50 pages or more usually
 
contain one to help readers locate specific information. An index entry cites the page or
 
location where the topic can be found, affording readers quick reference on a particular topic.
 
An index may identify and locate information, indicate its nature and scope, identify related
 
entries, and clarify relationships between entries. The arrangement and level of detail of the
 
index are determined by the structure of the report, its target audience, and its anticipated
 
uses.  
 
  
The most common type of index for a report is the subject index in which subjects are
+
:Each index entry has a heading (first element) and a locator (page, section number, or linking information) where information about the entry is found. Terms used as report headings are included in the index. The index contains all terms likely to be sought by the intended audience.
presented alphabetically. Other types of indexes (for example, name index, number, and
 
code index) may also be used. They are placed before the subject index in the back matter.  
 
  
In preparing an index, the number and kind of access points (entry locations) and the
+
==Applicable rules==
information level of indexable matter (for example, abstract or concrete) are determined.  
+
According to the [[ANSI/NISO Scientific and Technical Reports]] standard,
 +
:Always use lower case unless an entry begins with a proper name; indent entries uniformly for each level of modification. Indent runover lines deeper than the deepest subentry.  
  
Each index entry has a heading (first element) and a locator (page, section number, or linking
+
:;Non-Print-Specific
information) where information about the entry is found. Terms used as report headings are
+
::[[Best practice]] is to provide links between index terms and what they reference.
included in the index. The index contains all terms likely to be sought by the intended
 
audience.
 

Latest revision as of 20:06, 27 December 2020

A document index (hereinafter, the Index) is an alphabetical listing of discussed concepts, topics, and items and their location in a report or another document. The Index is a conditional part of report's back matter; it is included when a user may need to locate all references to a concept, topic, and/or item. When the Index is included, it functions as a part of document's structural metadata.


Description

The ANSI/NISO Scientific and Technical Reports standard details,

An index is an alphabetical listing of all major topics discussed in a report. An index is optional in short reports (fewer than 50 print pages), but reports of 50 pages or more usually contain one to help readers locate specific information. An index entry cites the page or location where the topic can be found, affording readers quick reference on a particular topic. An index may identify and locate information, indicate its nature and scope, identify related entries, and clarify relationships between entries. The arrangement and level of detail of the index are determined by the structure of the report, its target audience, and its anticipated uses.
The most common type of index for a report is the subject index in which subjects are presented alphabetically. Other types of indexes (for example, name index, number, and code index) may also be used. They are placed before the subject index in the back matter.
In preparing an index, the number and kind of access points (entry locations) and the information level of indexable matter (for example, abstract or concrete) are determined.
Each index entry has a heading (first element) and a locator (page, section number, or linking information) where information about the entry is found. Terms used as report headings are included in the index. The index contains all terms likely to be sought by the intended audience.

Applicable rules

According to the ANSI/NISO Scientific and Technical Reports standard,

Always use lower case unless an entry begins with a proper name; indent entries uniformly for each level of modification. Indent runover lines deeper than the deepest subentry.
Non-Print-Specific
Best practice is to provide links between index terms and what they reference.