From 0f2ffa2a3b710b35c0582efdb6bbbdfc576b4e2f Mon Sep 17 00:00:00 2001 From: Mike Shallcross Date: Tue, 14 Apr 2026 12:00:23 -0400 Subject: [PATCH 1/6] updated input guidance for geographic coverage area --- schema/yaml/geographic_coverage_area.yaml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/schema/yaml/geographic_coverage_area.yaml b/schema/yaml/geographic_coverage_area.yaml index e1febe0..c01a6de 100644 --- a/schema/yaml/geographic_coverage_area.yaml +++ b/schema/yaml/geographic_coverage_area.yaml @@ -10,4 +10,10 @@ * 'Global' may be appropriate for studies where the universe of participants is truly worldwide. Possible examples include online surveys that are not restricted by geography, or studies of organizations, such as NGOs. * County-level information is typically not indicated. If a U.S. county will be included, the state name and 'United States' must be listed as well. - The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vocabularies/tgn/index.html) is referenced when introducing new geographic names. \ No newline at end of file + The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vocabularies/tgn/index.html) is referenced when introducing new geographic names. + + icpsrGuidance: | + + The metadata editor will automatically put this element's values in alphabetical order, regardless of hierarchy. + + For United States-based data collections that include some or all U.S. island territories (e.g., American Samoa, Puerto Rico, Northern Mariana Islands, Virgin Islands of the United States, and Guam), list each of these territories separately in the Geographic Coverage Areas field. \ No newline at end of file From ca6694cf8ba810f27159509a059618bd209fc54c Mon Sep 17 00:00:00 2001 From: shallcro Date: Tue, 14 Apr 2026 16:01:01 +0000 Subject: [PATCH 2/6] Generated new copy of schema in markdown --- markdown/icpsr_study_schema.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/markdown/icpsr_study_schema.md b/markdown/icpsr_study_schema.md index 9b90bdf..bc210e8 100644 --- a/markdown/icpsr_study_schema.md +++ b/markdown/icpsr_study_schema.md @@ -1,6 +1,6 @@ # ICPSR Metadata Schema -Last updated: January 05, 2026 +Last updated: April 14, 2026 This is the metadata schema used to describe data collections at the Inter-university Consortium for Political and Social Research (ICPSR). These rules and definitions represent ICPSR's metadata practices and are intended to (a) assist ICPSR staff with metadata entry, and (b) help ICPSR users -- including data depositors and researchers accessing data -- understand how to use and interpret our metadata. @@ -998,7 +998,7 @@ Each geographic term's full hierarchy must be included; please note: * 'Global' may be appropriate for studies where the universe of participants is truly worldwide. Possible examples include online surveys that are not restricted by geography, or studies of organizations, such as NGOs. * County-level information is typically not indicated. If a U.S. county will be included, the state name and 'United States' must be listed as well. -The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vocabularies/tgn/index.html) is referenced when introducing new geographic names. +The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vocabularies/tgn/index.html) is referenced when introducing new geographic names. **ICPSR Input Guidance:** The metadata editor will automatically put this element's values in alphabetical order, regardless of hierarchy. From 8d538a1f37aefd5fed40a54cd0d54289af0eb77b Mon Sep 17 00:00:00 2001 From: Mike Shallcross Date: Tue, 14 Apr 2026 12:01:26 -0400 Subject: [PATCH 3/6] updated schema --- schema/icpsr_study_schema.json | 1 - 1 file changed, 1 deletion(-) diff --git a/schema/icpsr_study_schema.json b/schema/icpsr_study_schema.json index 15f9bb7..9867ff6 100644 --- a/schema/icpsr_study_schema.json +++ b/schema/icpsr_study_schema.json @@ -378,7 +378,6 @@ "minItems": 1, "controlledVocab": "[ICPSR Geographic Names Thesaurus](https://www.icpsr.umich.edu/web/ICPSR/thesaurus/10003).", "$ref": "https://schemas.icpsr.umich.edu/schema/yaml/geographic_coverage_area?version=v1", - "icpsrGuidance": "The metadata editor will automatically put this element's values in alphabetical order, regardless of hierarchy.", "examples": [ ["United States", "Maryland", "Baltimore"], ["United Kingdom", "China"], From f07f041188e9bba254f4fe7277b8b727c839de4a Mon Sep 17 00:00:00 2001 From: Mike Shallcross Date: Tue, 14 Apr 2026 12:04:18 -0400 Subject: [PATCH 4/6] updated yaml --- schema/yaml/geographic_coverage_area.yaml | 3 --- 1 file changed, 3 deletions(-) diff --git a/schema/yaml/geographic_coverage_area.yaml b/schema/yaml/geographic_coverage_area.yaml index c01a6de..957c433 100644 --- a/schema/yaml/geographic_coverage_area.yaml +++ b/schema/yaml/geographic_coverage_area.yaml @@ -2,7 +2,6 @@ $schema: https://json-schema.org/draft-07/schema# $id: https://schemas.icpsr.umich.edu/schema/yaml/geographic_coverage_area?version=v1 usageNotes: | - Each geographic term's full hierarchy must be included; please note: * For a U.S. city, the state and country are listed alongside (e.g., 'Los Angeles, California, United States'). @@ -11,9 +10,7 @@ * County-level information is typically not indicated. If a U.S. county will be included, the state name and 'United States' must be listed as well. The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vocabularies/tgn/index.html) is referenced when introducing new geographic names. - icpsrGuidance: | - The metadata editor will automatically put this element's values in alphabetical order, regardless of hierarchy. For United States-based data collections that include some or all U.S. island territories (e.g., American Samoa, Puerto Rico, Northern Mariana Islands, Virgin Islands of the United States, and Guam), list each of these territories separately in the Geographic Coverage Areas field. \ No newline at end of file From 09e314f79256bdc6ad2c73190bf7a8d2709966b5 Mon Sep 17 00:00:00 2001 From: shallcro Date: Tue, 14 Apr 2026 16:05:38 +0000 Subject: [PATCH 5/6] Generated new copy of schema in markdown --- markdown/icpsr_study_schema.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/markdown/icpsr_study_schema.md b/markdown/icpsr_study_schema.md index bc210e8..4b0f159 100644 --- a/markdown/icpsr_study_schema.md +++ b/markdown/icpsr_study_schema.md @@ -990,8 +990,7 @@ The Summary is written in the third person and avoids attempting to address issu **Controlled Vocabulary:** [ICPSR Geographic Names Thesaurus](https://www.icpsr.umich.edu/web/ICPSR/thesaurus/10003). -**Usage Notes:** -Each geographic term's full hierarchy must be included; please note: +**Usage Notes:** Each geographic term's full hierarchy must be included; please note: * For a U.S. city, the state and country are listed alongside (e.g., 'Los Angeles, California, United States'). * Non-U.S. geographic subdivisions need not include hierarchical relations, with the specific exceptions of Canadian provinces and the countries within the United Kingdom. @@ -1002,6 +1001,8 @@ The [Getty Thesaurus of Geographic Names](http://www.getty.edu/research/tools/vo **ICPSR Input Guidance:** The metadata editor will automatically put this element's values in alphabetical order, regardless of hierarchy. +For United States-based data collections that include some or all U.S. island territories (e.g., American Samoa, Puerto Rico, Northern Mariana Islands, Virgin Islands of the United States, and Guam), list each of these territories separately in the Geographic Coverage Areas field. + **Examples:** ```json From 49ddd24d3daf413b5769b0773e216ea0dfa23e8d Mon Sep 17 00:00:00 2001 From: Mike Shallcross Date: Tue, 14 Apr 2026 12:07:56 -0400 Subject: [PATCH 6/6] updated version history --- markdown/version_history.md | 1 + 1 file changed, 1 insertion(+) diff --git a/markdown/version_history.md b/markdown/version_history.md index 77bc9be..87f5464 100644 --- a/markdown/version_history.md +++ b/markdown/version_history.md @@ -2,6 +2,7 @@ | Date | Version | Note | |------|---------|------| +| April 14, 2026 | v1.3 | Updated ICPSR input guidance for Geographic Coverage Area. | | April 11, 2025 | v1.2 | Updated field definitions to improve clarity. | | June 28, 2024 | v1.1 | Removed guidance regarding null entries for National Institute of Justice studies. Several fields previously required "None" when otherwise a field would be left blank. Updated internal guidance for 'external source id' and 'funding purpose' elements. Added 'study number' and distributor 'order' elements to address earlier oversights. | | Oct. 30, 2023 | v1 | Initial release and publication of the ICPSR Metadata Schema. |