Merge pull request #267 from tdwg/issue256

Made it explicit that the QRG is not part of the standard, but that i…

README.md

@@ -8,7 +8,7 @@ Darwin Core is a standard maintained by the Darwin Core maintenance group. It in
 
 Documents:
 
-* [Normative document](vocabulary/term_versions.csv): a CSV file with the full version history of Darwin Core terms
+* [Complete term history table](vocabulary/term_versions.csv): a CSV file with the full version history of Darwin Core terms
 * [Distribution documents](dist/): Simple CSV files to start using Darwin Core
 * [Website documents](docs/): Markdown files that form the source for the [Darwin Core website](https://dwc.tdwg.org/)
 

build/terms.tmpl

@@ -1,14 +1,14 @@
 {#
-    This template is NOT use by jekyll, but by the Darwin Core build script
-    to create the terms/index.md file which mostly contains html.
+    This template is NOT used by jekyll, but by the Darwin Core build script
+    to create the terms/index.md file, which mostly contains html.
 #}
 ---
 container: fluid
 ---
 
 # Darwin Core quick reference guide
 
-This page provides a list of all currently recommended terms of the Darwin Core standard. Categories such as `Occurrence` or `Event` correspond to Darwin Core classes which group other terms. Convenient [files of these terms](https://github.com/tdwg/dwc/tree/master/dist) and [their full history](https://github.com/tdwg/dwc/blob/master/vocabulary/term_versions.csv) can be found in the [Darwin Core repository](https://github.com/tdwg/dwc).
+This document is intended to be an easy-to-read reference of the currently recommended terms maintained as part of the [Darwin Core standard](https://www.tdwg.org/standards/dwc/). This page itself is not part of the standard. It draws on the term names and definitions from the normative part of the standard and combines them with comments and examples that are not normative, but that are meant to help people to use the terms consistently. Categories such as `Occurrence` and `Event` correspond to Darwin Core classes, which are special category terms used to group sets of terms for convenience. [Files with lists of these terms](https://github.com/tdwg/dwc/tree/master/dist) and [their full history](https://github.com/tdwg/dwc/blob/master/vocabulary/term_versions.csv) can be found in the [Darwin Core repository](https://github.com/tdwg/dwc).
 
 {% for class_group in class_groups %}