next batch of field edits

rmseifried · rmseifried · commit 765167fc273f · 2025-07-25T15:00:22.000-04:00
diff --git a/docs/ogm-aardvark.md b/docs/ogm-aardvark.md
@@ -2,9 +2,11 @@
 
 !!! info "Definitions"
 
-	Mandatory = meets the minimum community standard
+	**Mandatory** = meets the minimum community standard for high-quality metadata
 
-	Suggested = improves searching and/or citation generation
+	**Suggested** = improves searching and/or citation generation
+	
+	To check which fields are required for current GeoBlacklight functionality, see the [GeoBlacklight documentation](https://geoblacklight.org/docs/metadata/)
 
 {{ read_csv('ogm-aardvark/ogm-aardvark.csv') }}
 
diff --git a/docs/ogm-aardvark/bounding-box.csv b/docs/ogm-aardvark/bounding-box.csv
@@ -2,7 +2,7 @@ Label,Bounding Box
 URI,https://opengeometadata.org/ogm-aardvark/#bounding-box
 Field Name,dcat_bbox
 Field Type,String
-Obligation,Mandatory - used in GeoBlacklight software to provide more relevant search results
+Obligation,Mandatory - used to provide more relevant search results in GeoBlacklight
 Multivalued,False
 Purpose,To support overlap ratio boosting in spatial searches.
 Entry Guidelines,"This should be a bounding box in this format: ENVELOPE(W,E,N,S)."
diff --git a/docs/ogm-aardvark/id.csv b/docs/ogm-aardvark/id.csv
@@ -2,12 +2,12 @@ Label,ID
 URI,https://opengeometadata.org/ogm-aardvark/#id
 Field Name,id
 Field Type,String
-Obligation,Required
+Obligation,Mandatory - serves as the unique identifier; critical from GeoBlacklight functioning
 Multivalued,False
 Purpose,To provide a unique text string for the item that will act as the primary key in Solr and to create a unique landing page for the item.
 Entry Guidelines,"Enter a string that only contains alpha-numeric characters (A-Z, a-z, 0-9), hyphens, underscores, and colons. This ID must be unique within your instance's GeoBlacklight index."
 Commentary,"The value of this field will appear in Geoblacklight's URL for the item.  It is visible to the user and is used to create permalinks.  Although it may be possible to use other non-Latin or punctuation characters, this is not recommended, as these characters may get percent-escaped in the URLs, or even lead to broken links or other problems.  Since it is common to include records from other institutions, it is recommended that any records you create are prefixed with the short form of your institution's name to avoid collisions with records from other providers."
 Controlled Vocabulary,No
 Example Value,"""princeton-rv042w38t"""
 Element Set,GBL
-Group,"[Identifiers](../ogm-aardvark/#identifiers)"
+Group,Identifiers
diff --git a/docs/ogm-aardvark/identifier.csv b/docs/ogm-aardvark/identifier.csv
@@ -2,12 +2,12 @@ Label,Identifier
 URI,https://opengeometadata.org/ogm-aardvark/#identifier
 Field Name,dct_identifier_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Optional
 Multivalued,True
 Purpose,To provide a general purpose field for identifiers.
 Entry Guidelines,"Enter a DOI, catalog number, and/or other system number."
 Commentary,"This is a general purpose field that can contain one or more string values. Ideally, at least one value would be a persistent identifier or permalink (such as a PURL or Handle). Additional values could be other identifiers used by the resource, such as the call number, OCLC number, or other system identifier. This field is not displayed in the interface."
 Controlled Vocabulary,No
 Example Value,"[""5864 .L7 E635 1998 .G7""]"
 Element Set,DCMI
-Group,"[Identifiers](../ogm-aardvark/#identifiers)"
+Group,Identifiers
diff --git a/docs/ogm-aardvark/index-year.csv b/docs/ogm-aardvark/index-year.csv
@@ -2,12 +2,12 @@ Label,Index Year
 URI,https://opengeometadata.org/ogm-aardvark/#index-year
 Field Name,gbl_indexYear_im
 Field Type,Array of integers
-Obligation,Suggested
+Obligation,Suggested - powers a search facet in GeoBlacklight
 Multivalued,True
 Purpose,"To power the ""Year"" facet and time slider widgets that rely on integers for dates."
 Entry Guidelines,Enter one or more 4-digit integers.
 Commentary,"Ideally this field should describe the date(s) depicted in a resource. Because it powers the ""Year"" facet, it is one of the key ways users can find items by their date."
 Controlled Vocabulary,No
 Example Value,"[1980,1981,1982]"
 Element Set,GBL
-Group,"[Temporal](../ogm-aardvark/#temporal)"
+Group,[Temporal](../temporal-fields)
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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
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](../ogm-aardvark/#categories)"
+Group,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](../ogm-aardvark/#descriptive)"
+Group,Descriptive
diff --git a/docs/ogm-aardvark/license.csv b/docs/ogm-aardvark/license.csv
@@ -10,4 +10,4 @@ Commentary,"This field is only for URIs of known licenses. Do not enter a rights
 Controlled Vocabulary,No
 Example Value,"[""https://creativecommons.org/licenses/by/4.0/""]"
 Element Set,DCMI
-Group,"[Rights](../ogm-aardvark/#rights)"
+Group,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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
diff --git a/docs/ogm-aardvark/metadata-version.csv b/docs/ogm-aardvark/metadata-version.csv
@@ -2,12 +2,12 @@ Label,Metadata Version
 URI,https://opengeometadata.org/ogm-aardvark/#metadata-version
 Field Name,gbl_mdVersion_s
 Field Type,String
-Obligation,Required
+Obligation,Mandatory - harvesters rely on this field to parse metadata
 Multivalued,False
 Purpose,To clarify which GeoBlacklight metadata schema is being used.
 Entry Guidelines,Enter a string: "GBL 1.0" or "Aardvark".
 Commentary,"There have been two metadata schema versions for GeoBlacklight applications: GeoBlacklight 1.0 (abbreviated to GBL 1.0) and OpenGeoMetadata Aardvark (abbreviated to Aardvark)."
 Controlled Vocabulary,Yes - strict
 Example Value,"""Aardvark"""
 Element Set,GBL
-Group,"[Admin](../ogm-aardvark/#admin)"
+Group,Admin
diff --git a/docs/ogm-aardvark/modified.csv b/docs/ogm-aardvark/modified.csv
@@ -2,12 +2,12 @@ Label,Modified
 URI,https://opengeometadata.org/ogm-aardvark/#modified
 Field Name,gbl_mdModified_dt
 Field Type,String
-Obligation,Required
+Obligation,Optional
 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:<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,"[Admin](../ogm-aardvark/#admin)"
+Group,Admin
diff --git a/docs/ogm-aardvark/provider.csv b/docs/ogm-aardvark/provider.csv
@@ -2,12 +2,12 @@ Label,Provider
 URI,https://opengeometadata.org/ogm-aardvark/#provider
 Field Name,schema_provider_s
 Field Type,String
-Obligation,Suggested
+Obligation,Mandatory - describes provenance; used to determine if a resource is accessible to a user
 Multivalued,False
 Purpose,To clarify which organization holds the resource or acts as the custodian for the metadata record and to help users understand which resources they can access.
 Entry Guidelines,"This field can be any string value. However, if the value corresponds to the name of an SVG icon in GeoBlacklight, the icon will display next to the title. See the GeoBlacklight documentation on [adding SVG Icons](https://geoblacklight.org/docs/adding_svg_icons/) for more details."
 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](../ogm-aardvark/#credits)"
+Group,Credits
diff --git a/docs/ogm-aardvark/publisher.csv b/docs/ogm-aardvark/publisher.csv
@@ -2,12 +2,12 @@ Label,Publisher
 URI,https://opengeometadata.org/ogm-aardvark/#publisher
 Field Name,dct_publisher_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Suggested - helpful for generating citations
 Multivalued,True
 Purpose,To credit the entity that made a resource available for the first time.
 Entry Guidelines,The suggested controlled vocabulary is the [Library of Congress Name Authority File](https://id.loc.gov/authorities/names.html).
 Commentary,"The distinction between Publisher and [Creator](../ogm-aardvark/#creator) for data is often vague. Publishers should be the administrative body or organization that made the original resource available, regardless of who compiled or produced the data."
 Controlled Vocabulary,No
 Example Value,"[""ML InfoMap (Firm)""]"
 Element Set,DCMI
-Group,"[Credits](../ogm-aardvark/#credits)"
+Group,Credits
diff --git a/docs/ogm-aardvark/references.csv b/docs/ogm-aardvark/references.csv
@@ -2,12 +2,12 @@ Label,References
 URI,https://opengeometadata.org/ogm-aardvark/#references
 Field Name,dct_references_s
 Field Type,String (serialized JSON)
-Obligation,Suggested
+Obligation,Mandatory - used for download links and to direct users to more information
 Multivalued,False
 Purpose,To provide external URLs for accessing or describing the resource.
 Entry Guidelines,"This field defines external services and references using the CatInterOp approach. The field value is a serialized JSON array of key/value pairs, with keys representing namespace URI's and values the URL. See [Configure References Links](../configure-references-links/) for detailed information about configuring this field."
 Commentary,"All of the external links for the resource are listed as a serialized JSON array of key/value pairs. The download key (`http://schema.org/downloadUrl`) is unique becaues it can be formatted as an array; see the section on [multiple downloads](../configure-references-links/#multiple-downloads) for formatting guidelines."
 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](../ogm-aardvark/#links)"
+Group,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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
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](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
diff --git a/docs/ogm-aardvark/resource-class.csv b/docs/ogm-aardvark/resource-class.csv
@@ -2,12 +2,12 @@ Label,Resource Class
 URI,https://opengeometadata.org/ogm-aardvark/#resource-class
 Field Name,gbl_resourceClass_sm
 Field Type,Array of strings
-Obligation,Required
+Obligation,Mandatory - helpful for starting a search
 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 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](../ogm-aardvark/#categories)"
+Group,Categories
diff --git a/docs/ogm-aardvark/resource-type.csv b/docs/ogm-aardvark/resource-type.csv
@@ -2,12 +2,12 @@ Label,Resource Type
 URI,https://opengeometadata.org/ogm-aardvark/#resource-type
 Field Name,gbl_resourceType_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Suggested - helpful for narrowing down a search
 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 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](../ogm-aardvark/#categories)"
+Group,Categories
diff --git a/docs/ogm-aardvark/rights-holder.csv b/docs/ogm-aardvark/rights-holder.csv
@@ -10,4 +10,4 @@ Commentary,"This field can be used for instances in which an an organization own
 Controlled Vocabulary,No
 Example Value,"""Johns Hopkins University Libraries"""
 Element Set,DCMI
-Group,"[Rights](../ogm-aardvark/#rights)"
+Group,Rights
diff --git a/docs/ogm-aardvark/rights.csv b/docs/ogm-aardvark/rights.csv
@@ -2,12 +2,12 @@ Label,Rights
 URI,https://opengeometadata.org/ogm-aardvark/#rights_1
 Field Name,dct_rights_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Optional
 Multivalued,True
 Purpose,"To provide a free text field for rights information, such as usage, access, or copyright."
 Entry Guidelines,"Enter free text of generic, catch-all access and usage rights."
 Commentary,"This field is intended to be flexible to accommodate different types of rights and disclaimers. Users are encouraged to adopt one of the rightsstatements.org statements. This is a plain text field by default, but it can include clickable links if the GeoBlacklight software is customized; see the GeoBlacklight documentation on [rendering HTML in metadata fields](https://geoblacklight.org/docs/rendering_html_from_description/)."
 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,"[Rights](../ogm-aardvark/#rights)"
+Group,Rights
diff --git a/docs/ogm-aardvark/source.csv b/docs/ogm-aardvark/source.csv
@@ -10,4 +10,4 @@ Commentary,"This is one of several fields that describe how records relate to ea
 Controlled Vocabulary,No
 Example Value,"[""abcd-988763""]"
 Element Set,DCMI
-Group,"[Relations](../ogm-aardvark/#relations)"
+Group,[Relations](../relations-fields)
diff --git a/docs/ogm-aardvark/spatial-coverage.csv b/docs/ogm-aardvark/spatial-coverage.csv
@@ -2,12 +2,12 @@ Label,Spatial Coverage
 URI,https://opengeometadata.org/ogm-aardvark/#spatial-coverage
 Field Name,dct_spatial_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Suggested - helpful for searching by place name
 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](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](../ogm-aardvark/#spatial)"
+Group,[Spatial](../spatial-fields)
diff --git a/docs/ogm-aardvark/subject.csv b/docs/ogm-aardvark/subject.csv
@@ -10,4 +10,4 @@ Commentary,"Institutions may rely on existing vocabularies specific to a field o
 Controlled Vocabulary,No
 Example Value,"[""Elections"", ""Voting""]"
 Element Set,DCMI
-Group,"[Categories](../ogm-aardvark/#categories)"
+Group,Categories
diff --git a/docs/ogm-aardvark/suppressed.csv b/docs/ogm-aardvark/suppressed.csv
@@ -10,4 +10,4 @@ Commentary,"This field is useful for multipart items with identical metadata, su
 Controlled Vocabulary,Yes - strict
 Example Value,"true or ""true"""
 Element Set,GBL
-Group,"[Admin](../ogm-aardvark/#admin)"
+Group,Admin
diff --git a/docs/ogm-aardvark/temporal-coverage.csv b/docs/ogm-aardvark/temporal-coverage.csv
@@ -2,12 +2,12 @@ Label,Temporal Coverage
 URI,https://opengeometadata.org/ogm-aardvark/#temporal-coverage
 Field Name,dct_temporal_sm
 Field Type,Array of strings
-Obligation,Suggested
+Obligation,Optional
 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."
 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](../ogm-aardvark/#temporal)"
+Group,[Temporal](../temporal-fields)
diff --git a/docs/ogm-aardvark/theme.csv b/docs/ogm-aardvark/theme.csv
@@ -2,12 +2,12 @@ Label,Theme
 URI,https://opengeometadata.org/ogm-aardvark/#theme
 Field Name,dcat_theme_sm
 Field Type,Array of strings
-Obligation,Optional
+Obligation,Suggested - helpful for starting a search
 Multivalued,True
 Purpose,To provide a dedicated field that is restricted to terms based on ISO Topic Categories.
 Entry Guidelines,"Insert one or more of the values from the list of [Theme Values](../ogm-aardvark/#theme-values) below."
 Commentary,"Although ISO Topic categories are well established and widely used, the spellings of these terms vary across domains and disciplines. The Aardvark schema uses shortened terms for better readability, and adds three new values ""Events"", ""Imagery"", and ""Land Cover"" (the latter two split from imageryBaseMapsEarthCover)."
 Controlled Vocabulary,Yes - strict
 Example Value,"[""Boundaries"", ""Land Cover""]"
 Element Set,DCAT
-Group,"[Categories](../ogm-aardvark/#categories)"
+Group,Categories
diff --git a/docs/ogm-aardvark/title.csv b/docs/ogm-aardvark/title.csv
@@ -2,12 +2,12 @@ Label,Title
 URI,https://opengeometadata.org/ogm-aardvark/#title
 Field Name,dct_title_s
 Field Type,String
-Obligation,Required
+Obligation,Mandatory - used to generate citations; GeoBlacklight will use a default placeholder if no title is provided
 Multivalued,False
 Purpose,To provide the user with the name of the resource.
 Entry Guidelines,Titles should include place names and dates when available.
 Commentary,"The title is the most prominent metadata field that users see when browsing or scanning search results. Since many datasets are created with ambiguous or non-unique titles, it may be worth the effort to improve or enhance them. The ideal sequence of a title is something akin to ""Topic of Layer: Place, Year."" Putting the year at the end of a title produces better search results, since titles are left-anchored."
 Controlled Vocabulary,No
 Example Value,"""Address Points: Ann Arbor, Michigan, 2010"""
 Element Set,DCMI
-Group,"[Descriptive](../ogm-aardvark/#descriptive)"
+Group,Descriptive
diff --git a/docs/ogm-aardvark/wxs-identifier.csv b/docs/ogm-aardvark/wxs-identifier.csv
@@ -2,12 +2,12 @@ Label,WxS Identifier
 URI,https://opengeometadata.org/ogm-aardvark/#wxs-identifier
 Field Name,gbl_wxsIdentifier_s
 Field Type,String
-Obligation,Conditionally required
+Obligation,Optional - only required if using GeoServer with a GeoBlacklight instance
 Multivalued,False
 Purpose,"To identify the layer or store for a WFS, WMS, or WCS web service so the application can construct the full web service link."
 Entry Guidelines,"Only the layer name is added here. The base service endpoint URLs (e.g. ""https://maps-public.geo.nyu.edu/geoserver/sdr/wms"") are added to the [References](../ogm-aardvark/#references) field."
 Commentary,This value is only used when a WxS service is listed in the [References](../ogm-aardvark/#references) field. The WxS Identifer is used to point to specific layers within an OGC geospatial web service. This field is not used for ArcGIS Rest Services.
 Controlled Vocabulary,No
 Example Value,"""druid:vr593vj7147"""
 Element Set,GBL
-Group,"[Links](../ogm-aardvark/#links)"
+Group,Links
