Skip to content
This repository was archived by the owner on Jun 18, 2024. It is now read-only.

Commit 08a6683

Browse files
committed
Updated metadata rationale
1 parent 802f0d8 commit 08a6683

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

Diff for: schema.md

+11-2
Original file line numberDiff line numberDiff line change
@@ -329,12 +329,21 @@ Rationale for Metadata Nomenclature
329329
----------------------
330330
We sought to be platform-independent and to align as much as possible with existing open standards.
331331

332-
To that end, our JSON key names are directly drawn from [DCAT](http://www.w3.org/TR/vocab-dcat/), with two exceptions.
332+
To that end, our JSON key names are directly drawn from [DCAT](http://www.w3.org/TR/vocab-dcat/), with a few exceptions.
333333

334-
We added the new **accessLevel** field to help easily sort datasets into our three existing categories: public, restricted, and private. This field means an agency can run a basic filter against its enterprise data catalog to generate a public-facing list of datasets that are, or *could one day be*, made publicly available (or, in the case of restricted data, available under certain conditions). This field also makes it easy for anyone to generate a list of datasets that *could* be made available but have not yet been released by filtering **accessLevel** to *public* and **accessURL** to *blank*.
334+
We added the new **accessLevel** field to help easily sort datasets into our three existing categories: public, restricted public, and non-public. This field means an agency can run a basic filter against its enterprise data catalog to generate a public-facing list of datasets that are, or *could one day be*, made publicly available (or, in the case of restricted data, available under certain conditions). This field also makes it easy for anyone to generate a list of datasets that *could* be made available but have not yet been released by filtering **accessLevel** to *public* and **accessURL** to *blank*.
335+
336+
We added the new **accessLevelComment** field for data stewards to explain how to access restricted public datasets, and for agencies to have a place to record (even if only internally) the reason for not releasing a non-public dataset.
337+
338+
We added the new **systemOfRecords** field for data stewards to optionally link to a relevant System of Records Notice URL. A System of Records is a group of any records under the control of any agency from which information is retrieved by the name of the individual or by some identifying number, symbol, or other identifier assigned to the individual.
339+
340+
We added the new **bureauCode** field to ensure every dataset is connected in a standard way with an agency bureau.
341+
342+
We added the new **programOffice** field to ensure that when applicable, every dataset is connected in a standard way with an agency program office.
335343

336344
With respect to [dcat:dataQuality](http://www.w3.org/TR/vocab-dcat/#property--data-quality), we intentionally did **not** use this field and instead chose a boolean. At the time of this memo's release, DCAT had no specific guidance on the use of this field, and we actually do: whether or not the data meets an agency’s Information Quality Guidelines.
337345

346+
338347
Additional Information
339348
----------------------
340349
* [Schema.org](http://schema.org)

0 commit comments

Comments
 (0)