rename URI to "field name" across site

Following up on work done in #95

Author: rmseifried

docs/aardvark-gbl-1-crosswalk.md

@@ -7,7 +7,7 @@ The following chart shows the full Aardvark schema and which GBL 1.0 fields can
 
 ## Elements without a crosswalk
 
-Most of the elements from GBL 1.0 can be crosswalked directly into OGM Aardvark. The values for these elements are the same - only the URI name has changed or the field has been converted to an array.  
+Most of the elements from GBL 1.0 can be crosswalked directly into OGM Aardvark. The values for these elements are the same - only the field name has changed or the field has been converted to an array.  
 
 However, there are three elements in GBL 1.0 that do not directly translate into OGM Aardvark. While they have been replaced with similar fields in OGM Aardvark, the **values themselves** would need to be altered during crosswalking.
 
@@ -24,4 +24,4 @@ However, there are three elements in GBL 1.0 that do not directly translate into
 **Is Part Of (`dct_isPartOf_sm`)**
 
 * GBL 1.0 Description: This multi-valued GBL 1.0 plain text field is for writing out the name of a collection. Example: `dct_isPartOf_sm:"Village Maps of India"`
-* Similar Aardvark element: The URI is the same in Aardvark, but it is now a non-literal field. The value must be one or more IDs that reference another record within the system. Example: `dct_isPartOf_sm:"princeton-z603r079s"`
+* Similar Aardvark element: The field name is the same in Aardvark, but it is now a non-literal field. The value must be one or more IDs that reference another record within the system. Example: `dct_isPartOf_sm:"princeton-z603r079s"`

docs/about-ogm-aardvark.md

@@ -15,9 +15,9 @@ Details about the OpenGeoMetadata metadata schema, OGM Aardvark
 *   **GBL 1.0**: The legacy metadata schema designed for GeoBlacklight versions 2.0-3.7. [The schema is documented on this Legacy page.](gbl-1.0.md)
 *   **OGM Aardvark**: The new metadata schema that is compatible with GeoBlacklight version 4.0.
 *   **GeoBlacklight**: When spelled out, GeoBlacklight refers to [the application itself](https://geoblacklight.org), not its namesake legacy metadata schema, GBL 1.0.
-*   **URI**: This is the name we give to the metadata element itself. For example, the URI for the Subject field is `dct_subject_sm`. 
-*   **Namespace**: This is how we signify which family of standards or schemas an element belongs to. For the GeoBlacklight schema, this takes the form of the URI’s prefix. For the URI `dct_subject_sm`,  `dct_` is the prefix and signifies that this element is from Dublin Core.
-*   **Solr field type**: This is the suffix appended to the URI and indicates what kind of Solr field should be indexed. For `dct_subject_sm`, the `_sm` stands for String Multiple. It indicates that the field type is a string and that it can have multiple values.
+*   **Field name**: This is the name we give to the metadata element itself. For example, the field name for the Subject field is `dct_subject_sm`.
+*   **Namespace**: This is how we signify which family of standards or schemas an element belongs to. For the GeoBlacklight schema, this takes the form of the field name's prefix. For `dct_subject_sm`,  `dct_` is the prefix and signifies that this element is from Dublin Core.
+*   **Solr field type**: This is the suffix appended to the field name and indicates what kind of Solr field should be indexed. For `dct_subject_sm`, the `_sm` stands for String Multiple. It indicates that the field type is a string and that it can have multiple values.
 *   **Value**: This is the information that is entered in a field. It may be free text (literal value) or a URI/code (nonliteral value).
 
 OGM Aardvark is a discovery metadata schema for geospatial resources. It was intentionally developed with cross-application in mind and can be used to describe geospatial assets of all kinds.
@@ -56,7 +56,7 @@ The minimal nature of the original GeoBlacklight schema combined with the growin
 
 The new set of rights elements are:
 
-| Label              | URI                     | Description and Entry Guidelines |
+| Label              | Field Name                     | Description and Entry Guidelines |
 |:-------------------|:------------------------|:---------------------------------|
 | Access Rights      | `dct_accessRights_s`    | One of two possible values, "Public" or "Restricted"; controls whether a user can preview or download an item. This element replaces `dc_rights_s`. |
 | Rights             | `dct_rights_sm`         | Free-text field for generic, catch-all access and usage rights. Can include clickable links. |
@@ -73,7 +73,7 @@ GeoBlacklight version 3.4 and earlier has an Item Relations widget that displays
 
 The new set of relationship elements are:
 
-| Label              | URI                     | Description and Entry Guidelines |
+| Label              | Field Name                     | Description and Entry Guidelines |
 |:-------------------|:------------------------|:---------------------------------|
 | Source             | `dct_source_sm`         | For items that have been derived from another item (e.g. a digitized shapefile from a historical map). |
 | Is Part Of         | `dct_isPartOf_sm`       | For items that are a subset of another item (e.g. a page in a book). This value type is changing from free-text in Version 1.0 to an ID (slug) in the new schema. |
@@ -84,7 +84,7 @@ The new set of relationship elements are:
 | Relation            | `dct_relation_sm`      | For a general purpose relation.  |
 
 
-#### Consistent namespaces for all metadata element URIs
+#### Consistent namespaces for all metadata element field names
 
 OGM Aardvark gives preference to elements found in established schemas over custom fields.
 
@@ -96,7 +96,7 @@ OGM Aardvark gives preference to elements found in established schemas over cust
 
 #### Multivalued elements whenever possible
 
-The original schema features several descriptive metadata fields that only accept one value. The new schema expands many of these to multiple. This changes the URI suffix from `_s` to` _sm`. Although it will not affect the GeoBlacklight functionality, this practice may conflict with indexing, as Solr will treat `dct_publisher_s` as a different field than `dct_publisher_sm`.
+The original schema features several descriptive metadata fields that only accept one value. The new schema expands many of these to multiple. This changes the field name suffix from `_s` to` _sm`. Although it will not affect the GeoBlacklight functionality, this practice may conflict with indexing, as Solr will treat `dct_publisher_s` as a different field than `dct_publisher_sm`.
 
 #### More intuitive name for unique key
 
@@ -158,6 +158,3 @@ Refinements to OpenGeoMetadata have continued through the work of the ongoing Me
 * Lena Denis (Johns Hopkins University)
 * Marc McGee (Harvard University)
 * Rebecca Seifried (UMass Amherst)
-
-
-

docs/gbl-1.0.md

@@ -9,7 +9,7 @@ hide:
 ---
 
 
-| Label 					                	| URL                    | Required | Recommended |
+| Label 					                	| Field Name             | Required | Recommended |
 |:----------------------------------|:-----------------------|:--------:|:-----------:|
 | [Identifier](#identifier)					| `dc_identifier_s`      | X        |             |
 | [Rights](#rights)					    		| `dc_rights_s`          | X        |             |
@@ -43,7 +43,7 @@ hide:
 
 | Label							    | Identifier|
 |:----------------------|:-----------|
-| uri					  	    	| `dc_identifier_s`|
+| Field Name					  	    	| `dc_identifier_s`|
 | Required				  		| yes|
 | Type							    | string|
 | Description					  | Unique identifier for layer as a URI. It should be globally unique across all institutions, assumed not to be end-user visible|
@@ -58,7 +58,7 @@ hide:
 
 | Label							| Rights|
 |:----------------------|:-----------|
-| uri							| `dc_rights_s`|
+| Field Name							| `dc_rights_s`|
 | Required						| yes|
 | Type							| string|
 | Description					| Signals access in the geoportal and is indicated by a padlock icon. Users need to sign in to download restricted items|
@@ -72,7 +72,7 @@ hide:
 
 | Label							| Title|
 |:----------------------|:-----------|
-| uri							| `dc_title_s`|
+| Field Name							| `dc_title_s`|
 | Required						| yes|
 | Type							| string|
 | Description					| The name of the resource|
@@ -86,7 +86,7 @@ hide:
 
 | Label							| Provenance|
 |:----------------------|:-----------|
-| uri							| `dct_provenance_s`|
+| Field Name							| `dct_provenance_s`|
 | Required						| yes|
 | Type							| string|
 | Description					| The name of the institution that holds the resource or acts as the custodian for the metadata record|
@@ -100,7 +100,7 @@ hide:
 
 | Label							| Schema Version|
 |:----------------------|:-----------|
-| uri							| `geoblacklight_version`	|
+| Field Name							| `geoblacklight_version`	|
 | Required						| yes|
 | Type							| string|
 | Description					| Indicates which version of the GeoBlacklight schema is in use|
@@ -114,7 +114,7 @@ hide:
 
 | Label							| Slug|
 |:----------------------|:-----------|
-| uri							| `layer_slug_s`|
+| Field Name							| `layer_slug_s`|
 | Required						| yes|
 | Type							| string|
 | Description					| This is a string appended to the base URL of a GeoBlacklight installation to create a unique landing page for each resource. It is visible to the user and serves the purpose of forming a persistent URL for each catalog item.|
@@ -128,7 +128,7 @@ hide:
 
 | Label 						| Bounding Box|
 |:----------------------|:-----------|
-| uri							| `solr_geom`|
+| Field Name							| `solr_geom`|
 | Required						| yes|
 | Type							| string|
 | Description					| The rectangular extents of the resource. Note that this field is indexed as a Solr spatial (RPT) field|
@@ -142,7 +142,7 @@ hide:
 
 | Label 						| Solr Year|
 |:----------------------|:-----------|
-| uri							| `solr_year_i`|
+| Field Name							| `solr_year_i`|
 | Required						| no|
 | Type							| integer|
 | Description					| A four digit integer representing a year of temporal coverage or date issued for the resource. This field is used to populate the Year facet and the optional [Blacklight Range Limit gem](https://github.com/projectblacklight/blacklight_range_limit)|
@@ -156,7 +156,7 @@ hide:
 
 | Label							| Creator|
 |:----------------------|:-----------|
-| uri 							| `dc_creator_sm`|
+| Field Name 							| `dc_creator_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| The person(s) or organization that created the resource|
@@ -170,7 +170,7 @@ hide:
 
 | Label| Description|
 |:----------------------|:-----------|
-| uri							| `dc_description_s`|
+| Field Name							| `dc_description_s`|
 | Required						| no|
 | Type							| string|
 | Description					| At minimum, this is a reiteration of the title in sentence format. Other relevant information, such as data creation methods, data sources, and special licenses, may also be included.|
@@ -184,7 +184,7 @@ hide:
 
 | Label							| Format|
 |:----------------------|:-----------|
-| uri							| `dc_format_s`|
+| Field Name							| `dc_format_s`|
 | Required						| yes, if download link is included AND if download URL is configured as a single key:value pair|
 | Type							| string|
 | Description					| This indicates the file format of the data. If a download link is included, this value displays on the item page in the button under the download widget|
@@ -198,7 +198,7 @@ hide:
 
 | Label							| Language|
 |:----------------------|:-----------|
-| uri							| `dc_language_sm`|
+| Field Name							| `dc_language_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| Indicates the language of the data or map|
@@ -212,7 +212,7 @@ hide:
 
 | Label							| Publisher|
 |:----------------------|:-----------|
-| uri							| `dc_publisher_s`|
+| Field Name							| `dc_publisher_s`|
 | Required						| no|
 | Type							| array|
 | Description					| The organization that made the original resource available|
@@ -226,7 +226,7 @@ hide:
 
 | Label							| Source|
 |:----------------------|:-----------|
-| uri							| `dc_source_sm`|
+| Field Name							| `dc_source_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| This is used to indicate parent/child relationships between data layers and activates the Data Relations widget in GeoBlacklight|
@@ -240,7 +240,7 @@ hide:
 
 | Label							| Subject|
 |:----------------------|:-----------|
-| uri							| `dc_subject_sm`|
+| Field Name							| `dc_subject_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| These are theme or topic keywords|
@@ -254,7 +254,7 @@ hide:
 
 | Label							| Type|
 |:----------------------|:-----------|
-| uri							| `dc_type_s`|
+| Field Name							| `dc_type_s`|
 | Required						| no|
 | Type							| string|
 | Description					| This is a general element to indicate the larger genre of the resource|
@@ -268,7 +268,7 @@ hide:
 
 | Label							| Is Part Of|
 |:----------------------|:-----------|
-| uri							| `dct_isPartOf_sm`|
+| Field Name							| `dct_isPartOf_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| Holding entity for the layer, such as the title of a collection|
@@ -282,7 +282,7 @@ hide:
 
 | Label							| Date Issued|
 |:----------------------|:-----------|
-| uri							| `dct_issued_s`|
+| Field Name							| `dct_issued_s`|
 | Required						| no|
 | Type							| string|
 | Description					| This is the publication date for the resource|
@@ -296,7 +296,7 @@ hide:
 
 | Label							| References|
 |:----------------------|:-----------|
-| uri							| `dct_references_s`|
+| Field Name							| `dct_references_s`|
 | Required						| no|
 | Type							| string|
 | Description					| This element is a hash of key/value pairs for different types of external links. It integrates external services and references using the CatInterOp approach|
@@ -310,7 +310,7 @@ hide:
 
 | Label							| Spatial Coverage|
 |:----------------------|:-----------|
-| uri							| `dct_spatial_sm`|
+| Field Name							| `dct_spatial_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| This field is for place name keywords|
@@ -324,7 +324,7 @@ hide:
 
 | Label							| Temporal Coverage|
 |:----------------------|:-----------|
-| uri							| `dct_temporal_sm`|
+| Field Name							| `dct_temporal_sm`|
 | Required						| no|
 | Type							| array|
 | Description					| This represents the "Ground Condition" of the resource, meaning the time period data was collected or is intended to represent. Displays on the item page in the Year value|
@@ -338,7 +338,7 @@ hide:
 
 | Label							| Geometry Type|
 |:----------------------|:-----------|
-| uri							| `layer_geom_type_s`|
+| Field Name							| `layer_geom_type_s`|
 | Required						| no|
 | Type							| string|
 | Description					| This element shows up as Data type in GeoBlacklight, and each value has an associated icon|
@@ -352,7 +352,7 @@ hide:
 
 | Label							| Layer ID|
 |:----------------------|:-----------|
-| uri							| `layer_id_s`|
+| Field Name							| `layer_id_s`|
 | Required						| no|
 | Type							| string|
 | Description					| Indicates the layer id for any WMS or WFS web services listed in the `dct_references_s` field|
@@ -366,7 +366,7 @@ hide:
 
 | Label							| Modified Date|
 |:----------------------|:-----------|
-| uri							| `layer_modified_dt`|
+| Field Name							| `layer_modified_dt`|
 | Required						| no|
 | Type							| date-time|
 | Description					| Last modification date for the metadata record|
@@ -380,7 +380,7 @@ hide:
 
 | Label							| Suppressed|
 |:----------------------|:-----------|
-| uri							| `suppressed_b`|
+| Field Name							| `suppressed_b`|
 | Required						| no|
 | Type							| boolean|
 | Description					| If set to True, the record will not appear in search results. If is still accessible from the Data Relations widget and via direct URL.|

docs/tables/ogm-aardvark-fields.csv

@@ -1,4 +1,4 @@
-Label,URI,Obligation
+Label,Field Name,Obligation
 ==**[Access Rights](ogm-aardvark/access-rights.md)**==,`dct_accessRights_s`,==**Required**==
 [Alternative Title](ogm-aardvark/alternative-title.md),`dct_alternative_sm`,Optional
 [Bounding Box](ogm-aardvark/bounding-box.md),`dcat_bbox`,Suggested
@@ -40,4 +40,4 @@ Label,URI,Obligation
 [Temporal Coverage](ogm-aardvark/temporal-coverage.md),`dct_temporal_sm`,Suggested
 [Theme](ogm-aardvark/theme.md),`dcat_theme_sm`,Optional
 ==**[Title](ogm-aardvark/title.md)**==,`dct_title_s`,==**Required**==
-[WxS Identifier](ogm-aardvark/wxs-identifier.md),`gbl_wxsIdentifier_s`,Conditional
+[WxS Identifier](ogm-aardvark/wxs-identifier.md),`gbl_wxsIdentifier_s`,Conditional

docs/tables/ogm-accessRights.csv

@@ -1,5 +1,5 @@
 Label,Access Rights
-URI,dct_accessRights_s
+Field Name,dct_accessRights_s
 Obligation,Required
 Multivalued,false
 Field type,string
@@ -9,4 +9,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

docs/tables/ogm-gbl1.csv

@@ -1,5 +1,5 @@
 Aardvark Label,OGM Aardvark,GBL 1.0,Note
-Access Rights,`dct_accessRights_s`,`dc_rights_s`,new URI name
+Access Rights,`dct_accessRights_s`,`dc_rights_s`,new field name
 Alternative Title,`dct_alternative_sm`,-,new field
 Bounding Box,`dcat_bbox`,`solr_geom`,new field
 Centroid,`dcat_centroid`,-,new field
@@ -11,18 +11,18 @@ File Size,`gbl_fileSize_s`,-,new field
 Format,`dct_format_s`,`dc_format_s`,new namespace
 Geometry,`locn_geometry`,`solr_geom`,new field
 Georeferenced,`gbl_georeferenced_b`,-,new field
-ID,`id`,`layer_slug_s`,new URI name
+ID,`id`,`layer_slug_s`,new field name
 Identifier,`dct_identifier_sm`,`dc_identifier_s`,new namespace; single to multi-valued
-Index Year,`gbl_indexYear_im`,`solr_year_i`,new URI name; single to multi-valued
+Index Year,`gbl_indexYear_im`,`solr_year_i`,new field name; single to multi-valued
 Is Part Of,`dct_isPartOf_sm`,-,new value type (see Elements without a crosswalk)
 Is Replaced By,`dct_isReplacedBy_sm`,-,new field
 Keyword,`dcat_keyword_sm`,-,new field
 Language,`dct_language_sm`,`dc_language_s or _sm`,new namespace; single to multi-valued
 License,`dct_license_sm`,-,new field
 Member Of,`pcdm_memberOf_sm`,-,new field
-Metadata Version,`gbl_mdVersion_s`,`geoblacklight_version`,new URI name
-Modified,`gbl_mdModified_dt`,`layer_modified_dt`,new URI name
-Provider,`schema_provider_s`,`dct_provenance_s`,new URI name
+Metadata Version,`gbl_mdVersion_s`,`geoblacklight_version`,new field name
+Modified,`gbl_mdModified_dt`,`layer_modified_dt`,new field name
+Provider,`schema_provider_s`,`dct_provenance_s`,new field name
 Publisher,`dct_publisher_sm`,`dc_publisher_s`,new namespace; single to multi-valued
 References,`dct_references_s`,`dct_references_s`,no change
 Relation,`dct_relation_sm`,-,new field
@@ -39,7 +39,7 @@ Temporal Coverage,`dct_temporal_sm`,`dct_temporal_sm`,no change
 Theme,`dcat_theme_sm`,-,new field
 Title,`dct_title_s`,`dc_title_s`,new namespace
 Version,`dct_isVersionOf_sm`,-,new field
-WxS Identifier,`gbl_wxsIdentifier_s`,`layer_id_s`,new URI name
+WxS Identifier,`gbl_wxsIdentifier_s`,`layer_id_s`,new field name
 -,-,`dc_type_s`,deprecated field
 -,-,`layer_geom_type_s`,deprecated field
--,-,`dc_isPartOf_sm`,"deprecated literal field, replaced by nonliteral dct_isPartOf_sm,, which takes an ID"
+-,-,`dc_isPartOf_sm`,"deprecated literal field, replaced by nonliteral dct_isPartOf_sm,, which takes an ID"