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

Commit 2db8e07

Browse files
committed
adding clarifications on null and empty strings
1 parent 1bb96ec commit 2db8e07

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

Diff for: catalog.md

+2
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,8 @@ JSON is a lightweight and simple way to represent machine-readable data. It is q
3939

4040
The JSON representation of the catalog should track directly with any other optional formats, with the exception that JSON keys should not contain the domain prefix (e.g., `dcterms:title` becomes `title` and `dcterms:description` becomes simply `description`). Catalogs should be composed of an array of JSON objects, and all fields other than keywords should be a string (where keywords is an array of strings).
4141

42+
Where optional fields are included in a catalog file but are unpopulated, they may be represented by a `null` value. They should not be represented by an empty string (`""`).
43+
4244
### RDFa Lite
4345

4446
[RDFa Lite](http://www.w3.org/TR/rdfa-lite/) is a subset of RDFa (Resource Description Framework in Attribute) that provides a common syntax for expressing metadata on websites in a way that computers can understand and begin to formulate knowledge about those data about your organization. RDFa Lite embeds itself in existing, standard HTML pages. For example, if previously a dataset was described as `<h2>Name of Dataset</h2>`, RDFa would extend that markup as `<h2 property="dcterms:title">Name of Dataset</h2>` (notice the additional of the property field). This additional metadata is not visible when the page is rendered, and does not affect the page layout or content. It simply provides an additional level of description for search engines, crawlers, and other programmatic consumers of your site's content. It is acceptable for the RDFa Lite file to contain only the machine-readable metadata, but agencies may wish to add human readable content to display the metadata to the public if they so desire.

0 commit comments

Comments
 (0)