Updated identifier guidance in response to #69

Author: philipashlock

Diff for: v1.1/examples/catalog-sample-extended.csv

@@ -1,4 +1,4 @@
 accessLevel,accrualPeriodicity,bureauCode,conformsTo,fn,hasEmail,describedBy,dataQuality,description,downloadURL,format,mediaType,identifier,issued,keyword,landingPage,language,license,modified,primaryITInvestmentUII,programCode,publisher,references,rights,spatial,systemOfRecords,temporal,theme,title,isPartOf
-public,R/P1Y,018:10,http://www.agency.gov/widget-taxonomy/,Jane Doe,mailto:[email protected],http://www.agency.gov/datasets/widgets-dictionary.html,true,This dataset provides national statistics on the production of widgets,https://data.agency.gov/datasets/widgets-statistics/widgets.csv,CSV,text/csv,widgets-0001,2011-11-22,"widget,manufacturing,factory",http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/zero/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Services,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government","http://agency.gov/docs/widgets-1.html,http://agency.gov/docs/widgets-2.html",This dataset has been given an international public domain dedication for worldwide reuse,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Manufacturing Statistics,
-public,R/P1Y,018:10,,James Doe,mailto:[email protected],,,This dataset provides ranges on widget phase modulation,,,,widget-modulators,2011-11-22,widgetmodulation,http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/mark/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government","http://agency.gov/docs/widgets-1.html,http://agency.gov/docs/widgets-2.html",This dataset is a U.S. Government Work and is not covered by copyright in the United States of America,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Phase Modulation Ranges,
-public,R/P1Y,018:10,,James Doe,mailto:[email protected],http://www.agency.gov/datasets/widget-modulation-dictionary.html,true,This dataset provides ranges on widget phase modulators for 2011,https://data.agency.gov/datasets/widgets-modulator-ranges.csv,CSV,text/csv,widget-modulation-2011,2011-11-22,"widget, modulation",http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/mark/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Modulation Program, Office of Citizen Services and Innovative Technologies, General Services Administration, U.S. Government","http://agency.gov/docs/widgets-1.html, http://agency.gov/docs/widgets-2.html",This dataset is a U.S. Government Work and is not covered by copyright in the United States of America,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Phase Modulation Ranges for 2011,widget-modulators
+public,R/P1Y,018:10,http://www.agency.gov/widget-taxonomy/,Jane Doe,mailto:[email protected],http://www.agency.gov/datasets/widgets-dictionary.html,true,This dataset provides national statistics on the production of widgets,https://data.agency.gov/datasets/widgets-statistics/widgets.csv,CSV,text/csv,http://dx.doi.org/10.7927/H4PZ56R2,2011-11-22,"widget,manufacturing,factory",http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/zero/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Services,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government","http://agency.gov/docs/widgets-1.html,http://agency.gov/docs/widgets-2.html",This dataset has been given an international public domain dedication for worldwide reuse,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Manufacturing Statistics,
+public,R/P1Y,018:10,,James Doe,mailto:[email protected],,,This dataset provides ranges on widget phase modulation,,,,http://dx.doi.org/10.7927/H4K64G12,2011-11-22,widgetmodulation,http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/mark/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government","http://agency.gov/docs/widgets-1.html,http://agency.gov/docs/widgets-2.html",This dataset is a U.S. Government Work and is not covered by copyright in the United States of America,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Phase Modulation Ranges,
+public,R/P1Y,018:10,,James Doe,mailto:[email protected],http://www.agency.gov/datasets/widget-modulation-dictionary.html,true,This dataset provides ranges on widget phase modulators for 2011,https://data.agency.gov/datasets/widgets-modulator-ranges.csv,CSV,text/csv,http://dx.doi.org/10.7927/H49P2ZKM,2011-11-22,"widget, modulation",http://agency.gov/widgets/data,en-US,http://creativecommons.org/publicdomain/mark/1.0/,2011-11-19T12:00:00Z,021-006227212,018:001,"Widget Modulation Program, Office of Citizen Services and Innovative Technologies, General Services Administration, U.S. Government","http://agency.gov/docs/widgets-1.html, http://agency.gov/docs/widgets-2.html",This dataset is a U.S. Government Work and is not covered by copyright in the United States of America,United States,http://www.agency.gov/widgets/sorn/,2009-09-01T12:00:00Z/2010-05-31T12:00:00Z,manufacturing,U.S. Widget Phase Modulation Ranges for 2011,widget-modulators

Diff for: v1.1/examples/catalog-sample.csv

@@ -1,4 +1,4 @@
 accessLevel,bureauCode,fn,hasEmail,description,downloadURL,mediaType,identifier,keyword,modified,programCode,publisher,title
-public,018:10,Jane Doe,mailto:[email protected],This dataset provides national statistics on the production of widgets,https://data.agency.gov/datasets/widgets-statistics/widgets.csv,text/csv,widgets-0001,"widget,manufacturing,factory",2011-11-19T12:00:00Z,018:001,"Widget Services,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Manufacturing Statistics
-public,018:10,James Doe,mailto:[email protected],This dataset provides ranges on widget phase modulation,,,widget-modulators,"widget,modulation",2011-11-19T12:00:00Z,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Phase Modulation Ranges
-public,018:10,James Doe,mailto:[email protected],This dataset provides ranges on widget phase modulators for 2011,https://data.agency.gov/datasets/widgets-modulator-ranges.csv,text/csv,widget-modulation-2011,"widget,modulation",2011-11-19T12:00:00Z,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Phase Modulation Ranges for 2011
+public,018:10,Jane Doe,mailto:[email protected],This dataset provides national statistics on the production of widgets,https://data.agency.gov/datasets/widgets-statistics/widgets.csv,text/csv,http://dx.doi.org/10.7927/H4PZ56R2,"widget,manufacturing,factory",2011-11-19T12:00:00Z,018:001,"Widget Services,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Manufacturing Statistics
+public,018:10,James Doe,mailto:[email protected],This dataset provides ranges on widget phase modulation,,,http://dx.doi.org/10.7927/H4K64G12,"widget,modulation",2011-11-19T12:00:00Z,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Phase Modulation Ranges
+public,018:10,James Doe,mailto:[email protected],This dataset provides ranges on widget phase modulators for 2011,https://data.agency.gov/datasets/widgets-modulator-ranges.csv,text/csv,http://dx.doi.org/10.7927/H49P2ZKM,"widget,modulation",2011-11-19T12:00:00Z,018:001,"Widget Modulation Program,Office of Citizen Services and Innovative Technologies,General Services Administration,U.S. Government",U.S. Widget Phase Modulation Ranges for 2011

Diff for: v1.1/examples/catalog-sample.json

@@ -28,7 +28,7 @@
           "accessURL": "https://data.agency.gov/api/widgets-statistics/"
         }
       ],
-      "identifier": "widgets-0001",
+      "identifier": "http://dx.doi.org/10.7927/H45X26V8",
       "keyword": [
         "widget",
         "manufacturing",
@@ -62,7 +62,7 @@
         "hasEmail": "mailto:[email protected]"
       },
       "description": "This dataset provides ranges on widget phase modulation",
-      "identifier": "widget-modulators",
+      "identifier": "http://dx.doi.org/10.7927/",
       "keyword": [
         "widget",
         "modulation"
@@ -101,7 +101,7 @@
           "mediaType": "text/csv"
         }
       ],
-      "identifier": "widget-modulation-2011",
+      "identifier": "http://dx.doi.org/10.7927/H49P2ZKM",
       "keyword": [
         "widget",
         "modulation"

Diff for: v1.1/schema.md

@@ -531,8 +531,8 @@ Dataset Fields {#Dataset}
 **Cardinality** | (1,1)
 **Required** | Yes, always
 **Accepted Values** | String
-**Usage Notes** | This field allows third parties to maintain a consistent record for datasets even if title or URLs are updated. Agencies may integrate an existing system for maintaining unique identifiers or enter arbitrary characters for this field. However, each identifier **must** be unique across the agency's catalog and remain fixed. Characters should be alphanumeric.
-**Example** |  `{"identifier":"1344"}`
+**Usage Notes** | This field allows third parties to maintain a consistent record for datasets even if title or URLs are updated. Agencies may integrate an existing system for maintaining unique identifiers. Each identifier **must** be unique across the agency's catalog and remain fixed. Characters should be alphanumeric. It is **highly recommended** that a [URI (preferably an HTTP URL)](http://tools.ietf.org/html/rfc3986#section-1.1.3), be used to provide a globally unique identifier. URLs should be designed and maintained to persist indefinitely regardless of whether the URL of the resource itself changes.
+**Example** |  `{"identifier":"http://dx.doi.org/10.7927/H4PZ56R2"}`
 
 {: .table .table-striped #isPartOf}
 **Field [#](#isPartOf){: .permalink}** | **isPartOf**