add links to categories and more copyedits

rmseifried · rmseifried · commit dbc92d170ed7 · 2023-06-16T15:02:11.000-04:00
diff --git a/docs/ogm-aardvark.md b/docs/ogm-aardvark.md
@@ -61,7 +61,7 @@
 
 #### Links
 - [References](#references) (S)
-- [WxS Identifier](#wxs-identifier)
+- [WxS Identifier](#wxs-identifier) (C)
 
 #### Identifiers
 - ==[ID](#id) (R)==
@@ -256,7 +256,7 @@ The following table lists terms from the OpenGeoMetadata community. They are mos
 ## Source
 {{ read_csv('ogm-aardvark/source.csv') }}
 
-## Spatial coverage
+## Spatial Coverage
 {{ read_csv('ogm-aardvark/spatial-coverage.csv') }}
 
 ## Subject
diff --git a/docs/ogm-aardvark/access-rights.csv b/docs/ogm-aardvark/access-rights.csv
@@ -10,4 +10,4 @@ Commentary,"This field can be set to ""Public"", which allows users to view and
 Controlled Vocabulary,Yes - strict
 Example Value,"""Public"""
 Element Set,DCMI
-Group,Rights
+Group,"[Rights](../ogm-aardvark/#rights)"
diff --git a/docs/ogm-aardvark/alternative-title.csv b/docs/ogm-aardvark/alternative-title.csv
@@ -10,4 +10,4 @@ Commentary,"For discoverability, improving titles for data is encouraged. This f
 Controlled Vocabulary,No
 Example Value,"[""NEZ H Districts""]"
 Element Set,DCMI
-Group,Descriptive
+Group,"[Descriptive](../ogm-aardvark/#descriptive)"
diff --git a/docs/ogm-aardvark/bounding-box.csv b/docs/ogm-aardvark/bounding-box.csv
@@ -10,4 +10,4 @@ Commentary,"If the [Geometry](../ogm-aardvark/#geometry) field uses the ENVELOPE
 Controlled Vocabulary,No
 Example Value,"""ENVELOPE(-111.1, -104.0, 45.0, 40.9)"""
 Element Set,DCAT
-Group,Spatial
+Group,"[Spatial](../ogm-aardvark/#spatial)"
diff --git a/docs/ogm-aardvark/centroid.csv b/docs/ogm-aardvark/centroid.csv
@@ -10,4 +10,4 @@ Commentary,This field is currently only supported by customizations to the GeoBl
 Controlled Vocabulary,No
 Example Value,"""46.4218,-94.087"""
 Element Set,DCAT
-Group,Spatial
+Group,"[Spatial](../ogm-aardvark/#spatial)"
diff --git a/docs/ogm-aardvark/creator.csv b/docs/ogm-aardvark/creator.csv
@@ -10,4 +10,4 @@ Commentary,"The distinction between Creator and [Publisher](../ogm-aardvark/#pub
 Controlled Vocabulary,No
 Example Value,"[""Geological Survey (U.S.)""]"
 Element Set,DCMI
-Group,Credits
+Group,"[Credits](../ogm-aardvark/#credits)"
diff --git a/docs/ogm-aardvark/date-issued.csv b/docs/ogm-aardvark/date-issued.csv
@@ -10,4 +10,4 @@ Commentary,"Although the field is optional, it is often useful when a clear [Tem
 Controlled Vocabulary,No
 Example Value,"""1999"""
 Element Set,DCMI
-Group,Temporal
+Group,"[Temporal](../ogm-aardvark/#temporal)"
diff --git a/docs/ogm-aardvark/date-range.csv b/docs/ogm-aardvark/date-range.csv
@@ -10,4 +10,4 @@ Commentary,"This field is not yet supported by GeoBlacklight, but the applicatio
 Controlled Vocabulary,No
 Example Value,"""[1980 TO 1995]"""
 Element Set,GBL
-Group,Temporal
+Group,"[Temporal](../ogm-aardvark/#temporal)"
diff --git a/docs/ogm-aardvark/description.csv b/docs/ogm-aardvark/description.csv
@@ -10,4 +10,4 @@ Commentary,"This field is the second-most prominent value (after [Title](../ogm-
 Controlled Vocabulary,No
 Example Value,"""This polygon shapefile represents boundaries of election districts in New York City. It was harvested from the NYC Open Data Portal."""
 Element Set,DCMI
-Group,Descriptive
+Group,"[Descriptive](../ogm-aardvark/#descriptive)"
diff --git a/docs/ogm-aardvark/display-note.csv b/docs/ogm-aardvark/display-note.csv
@@ -10,4 +10,4 @@ Commentary,"Starting in GeoBlacklight version 4.1, text in this field is promine
 Controlled Vocabulary,No
 Example Value,"[""Danger: This text will be displayed in a red box"",""Info: This text will be displayed in a blue box"",""Tip: This text will be displayed in a green box"",""Warning: This text will be displayed in a yellow box"",""This is text without a tag and it will be assigned the default 'note' style""]"
 Element Set,DCMI
-Group,Descriptive
+Group,"[Descriptive](../ogm-aardvark/#descriptive)"
diff --git a/docs/ogm-aardvark/file-size.csv b/docs/ogm-aardvark/file-size.csv
@@ -10,4 +10,4 @@ Commentary,"This field is intended to give users a sense of how large the data o
 Controlled Vocabulary,No
 Example Value,"""25.96 MB"""
 Element Set,GBL
-Group,Object
+Group,"[Object](../ogm-aardvark/#object)"
diff --git a/docs/ogm-aardvark/format.csv b/docs/ogm-aardvark/format.csv
@@ -10,4 +10,4 @@ Commentary,"This field is required if the download URL (`http://schema.org/downl
 Controlled Vocabulary,Yes - not strict
 Example Value,"""Shapefile"""
 Element Set,DCMI
-Group,Object
+Group,"[Object](../ogm-aardvark/#object)"
diff --git a/docs/ogm-aardvark/geometry.csv b/docs/ogm-aardvark/geometry.csv
@@ -10,4 +10,4 @@ Commentary,"Since this field is not repeatable, multiple polygons should be repr
 Controlled Vocabulary,No
 Example Value,"Simple bounding box: ""ENVELOPE(-111.1, -104.0, 45.0, 40.9)""  |  Bermuda Triangle: ""POLYGON((-80 25, -65 18, -64 33, -80 25))""  |  Split bounding box for Alaska: ""MULTIPOLYGON (((-179.3 51.1, -129.9 51.1, -129.9 71.5, -179.3 71.5, -179.3 51.1)),((172.3 51.2, 179.9 51.2, 179.9 53.1, 172.3 53.1, 172.3 51.2)))"""
 Element Set,LOCN
-Group,Spatial
+Group,"[Spatial](../ogm-aardvark/#spatial)"
diff --git a/docs/ogm-aardvark/georeferenced.csv b/docs/ogm-aardvark/georeferenced.csv
@@ -10,4 +10,4 @@ Commentary,This field can be a shortcut for users to find georeferenced maps. Ad
 Controlled Vocabulary,Yes - strict
 Example Value,"false or ""false"""
 Element Set,GBL
-Group,Spatial
+Group,"[Spatial](../ogm-aardvark/#spatial)"
diff --git a/docs/ogm-aardvark/id.csv b/docs/ogm-aardvark/id.csv
@@ -10,4 +10,4 @@ Commentary,"This field makes up the URL for the resource in GeoBlacklight. It is
 Controlled Vocabulary,No
 Example Value,"""princeton-rv042w38t"""
 Element Set,GBL
-Group,Identifiers
+Group,"[Identifiers](../ogm-aardvark/#identifiers)"
diff --git a/docs/ogm-aardvark/identifier.csv b/docs/ogm-aardvark/identifier.csv
@@ -10,4 +10,4 @@ Commentary,"This is a general purpose field that can contain one or more string
 Controlled Vocabulary,No
 Example Value,"[""5864 .L7 E635 1998 .G7""]"
 Element Set,DCMI
-Group,Identifiers
+Group,"[Identifiers](../ogm-aardvark/#identifiers)"
diff --git a/docs/ogm-aardvark/index-year.csv b/docs/ogm-aardvark/index-year.csv
@@ -10,4 +10,4 @@ Commentary,"Ideally this field should describe the date(s) depicted in a resourc
 Controlled Vocabulary,No
 Example Value,"[1980,1981,1982]"
 Element Set,GBL
-Group,Temporal
+Group,"[Temporal](../ogm-aardvark/#temporal)"
diff --git a/docs/ogm-aardvark/is-part-of.csv b/docs/ogm-aardvark/is-part-of.csv
@@ -10,4 +10,4 @@ Commentary,"This is one of several fields that describe how records relate to ea
 Controlled Vocabulary,No
 Example Value,"[""77f-0001""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/is-replaced-by.csv b/docs/ogm-aardvark/is-replaced-by.csv
@@ -10,4 +10,4 @@ Commentary,"This field can be used with [Replaces](../ogm-aardvark/#replaces) to
 Controlled Vocabulary,No
 Example Value,"[""cugir-007933""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/is-version-of.csv b/docs/ogm-aardvark/is-version-of.csv
@@ -10,4 +10,4 @@ Commentary,"If entering the ID of a parent record, see [Member Of](../ogm-aardva
 Controlled Vocabulary,No
 Example Value,"[""xyz-1234""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/keyword.csv b/docs/ogm-aardvark/keyword.csv
@@ -10,4 +10,4 @@ Commentary,This field may be used for administrative purposes or to facilitate t
 Controlled Vocabulary,No
 Example Value,"[""covid19"", ""vaccination rate""]"
 Element Set,DCAT
-Group,Categories
+Group,"[Categories](../ogm-aardvark/#categories)"
diff --git a/docs/ogm-aardvark/language.csv b/docs/ogm-aardvark/language.csv
@@ -10,4 +10,4 @@ Commentary,"This field is intended to indicate the language of the dataset, map,
 Controlled Vocabulary,"Yes - not strict. Ideally, choose from the ISO 639-3 language codes in the list of [Language Values](../ogm-aardvark/#language-values) below."
 Example Value,"[""eng""]"
 Element Set,DCMI
-Group,Descriptive
+Group,"[Descriptive](../ogm-aardvark/#descriptive)"
diff --git a/docs/ogm-aardvark/license.csv b/docs/ogm-aardvark/license.csv
@@ -5,9 +5,9 @@ Field Type,Array of strings
 Obligation,Optional
 Multivalued,True
 Purpose,"To provide URI links to specific, known licenses."
-Entry Guidelines,Enter a license URI. Recommended sources are Creative Commons or Open Data Commons.
+Entry Guidelines,"Enter a license URI. Recommended sources are [Creative Commons](https://creativecommons.org/) or [Open Data Commons](https://opendatacommons.org/)."
 Commentary,"This field is only for URIs of known licenses. Do not enter a rightsstatement.org statement here, because those belong in the [Rights](../ogm-aardvark/#rights_1) field."
 Controlled Vocabulary,No
 Example Value,"[""https://creativecommons.org/licenses/by/4.0/""]"
 Element Set,DCMI
-Group,Rights
+Group,"[Rights](../ogm-aardvark/#rights)"
diff --git a/docs/ogm-aardvark/member-of.csv b/docs/ogm-aardvark/member-of.csv
@@ -10,4 +10,4 @@ Commentary,"This is one of several fields that describe how records relate to ea
 Controlled Vocabulary,No
 Example Value,"[""xyz-12394""]"
 Element Set,PCDM
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/metadata-version.csv b/docs/ogm-aardvark/metadata-version.csv
@@ -10,4 +10,4 @@ Commentary,"There have been two metadata schema versions for GeoBlacklight appli
 Controlled Vocabulary,Yes - strict
 Example Value,"""Aardvark"""
 Element Set,GBL
-Group,Administrative
+Group,"[Admin](../ogm-aardvark/#admin)"
diff --git a/docs/ogm-aardvark/modified.csv b/docs/ogm-aardvark/modified.csv
@@ -5,9 +5,9 @@ Field Type,String
 Obligation,Required
 Multivalued,False
 Purpose,To inform administrators of when the metadata was last touched.
-Entry Guidelines,"Use the ""W3C Date and Time Format"" (YYYY-MM-DDThh:mm:ssZ)"
+Entry Guidelines,"Use the ""W3C Date and Time Format"" (YYYY-MM-DDThh:<zero-width space>mm:ssZ)"
 Commentary,This value should indicate when the metadata (not the resource itself) was last modified.
 Controlled Vocabulary,No
 Example Value,"""2015-01-01T12:00:00Z"""
 Element Set,GBL
-Group,Administrative
+Group,"[Admin](../ogm-aardvark/#admin)"
diff --git a/docs/ogm-aardvark/provider.csv b/docs/ogm-aardvark/provider.csv
@@ -10,4 +10,4 @@ Commentary,This field was named **Provenance** in the GBL 1.0 metadata schema.
 Controlled Vocabulary,Yes - not strict
 Example Value,"""University of Minnesota"""
 Element Set,schema.org
-Group,Credits
+Group,"[Credits](../ogm-aardvark/#credits)"
diff --git a/docs/ogm-aardvark/publisher.csv b/docs/ogm-aardvark/publisher.csv
@@ -10,4 +10,4 @@ Commentary,"The distinction between Publisher and [Creator](../ogm-aardvark/#cre
 Controlled Vocabulary,No
 Example Value,"[""ML InfoMap (Firm)""]"
 Element Set,DCMI
-Group,Credits
+Group,"[Credits](../ogm-aardvark/#credits)"
diff --git a/docs/ogm-aardvark/references.csv b/docs/ogm-aardvark/references.csv
@@ -10,4 +10,4 @@ Commentary,"All of the external links for the resource are listed as a serialize
 Controlled Vocabulary,"The ""key"" part of the key/value pairs are predefined in [Reference URIs](../reference-uris/)."
 Example Value,"""{\""http://schema.org/url\"":\""http://purl.stanford.edu/bm662dm5913\""}"""
 Element Set,DCMI
-Group,Links
+Group,"[Links](../ogm-aardvark/#links)"
diff --git a/docs/ogm-aardvark/relation.csv b/docs/ogm-aardvark/relation.csv
@@ -10,4 +10,4 @@ Commentary,"This is one of several fields that describe how records relate to ea
 Controlled Vocabulary,No
 Example Value,"[""aoeu-987643""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/replaces.csv b/docs/ogm-aardvark/replaces.csv
@@ -10,4 +10,4 @@ Commentary,"This field can be used on its own to point to an older deprecated da
 Controlled Vocabulary,No
 Example Value,"[""qrst-71717""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/resource-class.csv b/docs/ogm-aardvark/resource-class.csv
@@ -4,10 +4,10 @@ Field Name,gbl_resourceClass_sm
 Field Type,Array of strings
 Obligation,Required
 Multivalued,True
-Purpose,To provide a top level set of categories for classifying the item
-Entry Guidelines,Choose one or more terms from the list (see below).
+Purpose,To provide a top level set of categories for classifying the item.
+Entry Guidelines,"Choose one or more terms from the list of [Resource Class Values](../ogm-aardvark/#resource-class-values) below."
 Commentary,This field is intended to help users sort between significantly different types of resources.
 Controlled Vocabulary,Yes - strict
 Example Value,"[""Datasets""]"
 Element Set,GBL
-Group,Categories
+Group,"[Categories](../ogm-aardvark/#categories)"
diff --git a/docs/ogm-aardvark/resource-type.csv b/docs/ogm-aardvark/resource-type.csv
@@ -4,10 +4,10 @@ Field Name,gbl_resourceType_sm
 Field Type,Array of strings
 Obligation,Suggested
 Multivalued,True
-Purpose,To provide a secondary level of categories for classifying the spatial type or structure of a dataset
-Entry Guidelines,Choose one or more terms from the list (see below). Other terms are allowed.
+Purpose,To provide a secondary level of categories for classifying the spatial type or structure of a dataset.
+Entry Guidelines,Choose one or more terms from the lists of [Library of Congress](../ogm-aardvark/#resource-type-values-loc) or [OpenGeoMetadata](https://opengeometadata.org/ogm-aardvark/#resource-type-values-ogm) Resource Type Values below. Other terms are allowed.
 Commentary,This field combines an established list of terms for scanned maps (Cartographic Genres) and a custom list for geospatial data types. Additional terms are welcome - please submit them to the community for review and inclusion into the official vocabulary.
 Controlled Vocabulary,Yes - not strict
 Example Value,"[""Point data""]"
 Element Set,GBL
-Group,Categories
+Group,"[Categories](../ogm-aardvark/#categories)"
diff --git a/docs/ogm-aardvark/rights-holder.csv b/docs/ogm-aardvark/rights-holder.csv
@@ -4,10 +4,10 @@ Field Name,dct_rightsHolder_sm
 Field Type,Array of strings
 Obligation,Optional
 Multivalued,True
-Purpose,To clarify which person or organization owns or controls the rights for this version of the item
-Entry Guidelines,"Enter the name of the person or organization. If applicable, the suggested controlled vocabulary is the Library of Congress Name Authority File."
-Commentary,"This field can be used for instances in which an an organization owns a digital copy of an analog resource or otherwise controls access. This is different from Provider, which refers more to the resource or metadata steward."
+Purpose,To clarify which person or organization owns or controls the rights for this version of the item.
+Entry Guidelines,"Enter the name of the person or organization. If applicable, the suggested controlled vocabulary is the [Library of Congress Name Authority File](https://id.loc.gov/authorities/names.html)."
+Commentary,"This field can be used for instances in which an an organization owns or otherwise controls access of a digital copy of an analog resource. This is different from [Provider](../ogm-aardvark/#provider), which refers more to the resource or metadata steward."
 Controlled Vocabulary,No
 Example Value,"""Johns Hopkins University Libraries"""
 Element Set,DCMI
-Group,Rights
+Group,"[Rights](../ogm-aardvark/#rights)"
diff --git a/docs/ogm-aardvark/rights.csv b/docs/ogm-aardvark/rights.csv
@@ -10,4 +10,4 @@ Commentary,"This field is intended to be flexible to accommodate different types
 Controlled Vocabulary,No
 Example Value,"""All data is copyrighted by China Data Center and/or its suppliers. Derived works that include the source data must be merged with other value-added data in such a way that the derived work cannot be converted back to the original source data format. This data is licensed by UC Berkeley for research, educational, and other non-commercial use by authorized users, which include persons affiliated with UC Berkeley and walk-in users who must access the data in person at the library. [https://rightsstatements.org/page/InC/1.0/?language=en](https://rightsstatements.org/page/InC/1.0/?language=en)."""
 Element Set,DCMI
-Group,Bibliographic - general
+Group,"[Rights](../ogm-aardvark/#rights)"
diff --git a/docs/ogm-aardvark/source.csv b/docs/ogm-aardvark/source.csv
@@ -4,10 +4,10 @@ Field Name,dct_source_sm
 Field Type,Array of strings
 Obligation,Optional
 Multivalued,True
-Purpose,To link items that have been derived from another item (e.g. a digitized shapefile from a historical map)
+Purpose,To link items that have been derived from another item (e.g. a digitized shapefile from a historical map).
 Entry Guidelines,Enter the ID of the item(s) from which the resource was derived.
-Commentary,This is one of several fields that describe how records relate to each other. 
+Commentary,"This is one of several fields that describe how records relate to each other. This field is intended to describe a derivate relationship where the resource is based wholly on another, rather than being a version of it (see [Is Version Of](../ogm-aardvark/#is-version-of))." 
 Controlled Vocabulary,No
 Example Value,"[""abcd-988763""]"
 Element Set,DCMI
-Group,Relations
+Group,"[Relations](../ogm-aardvark/#relations)"
diff --git a/docs/ogm-aardvark/spatial-coverage.csv b/docs/ogm-aardvark/spatial-coverage.csv
@@ -4,10 +4,10 @@ Field Name,dct_spatial_sm
 Field Type,Array of strings
 Obligation,Suggested
 Multivalued,True
-Purpose,To provide the user with a list of searchable and selectable place names
-Entry Guidelines,Place name text strings should be specified out to the nation level. It is typical for the place name to represent the largest extent the data layer represents. Our recommended thesaurus is GeoNames.
-Commentary,It is recommended to have at least one place name for each layer that corresponds to the logical extent of the area of that layer.
+Purpose,To provide the user with a list of searchable and selectable place names.
+Entry Guidelines,"Place name text strings should be specified out to the nation level. It is typical for the place name to represent the largest extent the data layer represents. Our recommended thesaurus is [GeoNames](https://www.geonames.org/)."
+Commentary,"It is recommended to have at least one place name for each layer that corresponds to the logical extent of the area of that layer."
 Controlled Vocabulary,No
 Example Value,"[""Philadelphia, Pennsylvania, United States""]"
 Element Set,DCMI
-Group,Spatial
+Group,"[Spatial](../ogm-aardvark/#spatial)"
diff --git a/docs/ogm-aardvark/subject.csv b/docs/ogm-aardvark/subject.csv
@@ -4,10 +4,10 @@ Field Name,dct_subject_sm
 Field Type,Array of strings
 Obligation,Optional
 Multivalued,True
-Purpose,To provide an all-purpose field for subjects
+Purpose,To provide an all-purpose field for subjects.
 Entry Guidelines,"Any value is allowed, but controlled vocabularies are encouraged."
-Commentary,
+Commentary,"Institutions may rely on existing vocabularies specific to a field or project, or they may choose to develop their own set of controlled vocabularies."
 Controlled Vocabulary,No
 Example Value,"[""Elections"", ""Voting""]"
 Element Set,DCMI
-Group,Categories
+Group,"[Categories](../ogm-aardvark/#categories)"
diff --git a/docs/ogm-aardvark/suppressed.csv b/docs/ogm-aardvark/suppressed.csv
@@ -1,13 +1,13 @@
 Label,Suppressed
 URI,https://opengeometadata.org/ogm-aardvark/#suppressed
 Field Name,gbl_suppressed_b
-Field Type,boolean or string
+Field Type,Boolean or string
 Obligation,Optional
 Multivalued,False
-Purpose,"To hide items from users in the search results. If set to True, the record will not appear in search results. It is still accessible from the Data Relations widget and via direct URL."
+Purpose,"To hide items from users in the search results. If set to ""true"", the record will not appear in search results. It is still accessible from the data relations widgets and via direct URL."
 Entry Guidelines,Only one of two values are allowed: true or false.
 Commentary,"This field is useful for multipart items with identical metadata, such as pages in an atlas or series."
 Controlled Vocabulary,Yes - strict
 Example Value,"true or ""true"""
 Element Set,GBL
-Group,Administrative
+Group,"[Admin](../ogm-aardvark/#admin)"
diff --git a/docs/ogm-aardvark/temporal-coverage.csv b/docs/ogm-aardvark/temporal-coverage.csv
@@ -4,10 +4,10 @@ Field Name,dct_temporal_sm
 Field Type,Array of strings
 Obligation,Suggested
 Multivalued,True
-Purpose,To provide the user with a free text description of the time period or ranges of what is depicted in the resource
-Entry Guidelines,This is a text string and can indicate uncertainty.
+Purpose,"To provide the user with a free text description of the time period or ranges of what is depicted in the resource."
+Entry Guidelines,"This is a text string and can indicate uncertainty."
 Commentary,"Since this field is multi-valued, multiple strings can be used to indicate the time period the resource depicts, when the data was collected, and/or when the resources was created."
 Controlled Vocabulary,No
 Example Value,"[""1980-1995"", ""Late 20th century""]"
 Element Set,DCMI
-Group,Temporal
+Group,"[Temporal](../ogm-aardvark/#temporal)"
diff --git a/docs/ogm-aardvark/theme-vocabulary.csv b/docs/ogm-aardvark/theme-vocabulary.csv
diff --git a/docs/ogm-aardvark/theme.csv b/docs/ogm-aardvark/theme.csv
diff --git a/docs/ogm-aardvark/title.csv b/docs/ogm-aardvark/title.csv
diff --git a/docs/ogm-aardvark/wxs-identifier.csv b/docs/ogm-aardvark/wxs-identifier.csv
