diff --git a/README.md b/README.md index 7055161..6e7f9dc 100644 --- a/README.md +++ b/README.md @@ -3,11 +3,11 @@ ## TAP Attribute Dictionary The [TAP Attribute Dictionary](tap-core-person-schema.adoc) defines a large collection of -attributes used across various components of the TAP portfolio and higher education more generally. The -normative documentation of the TAP Attribute Dictionary is abstract -- it is designed to be used only when mapped to specific formats and protocols. It is -best thought of as an *attribute library* that can be drawn from to construct other documents, specifications, and software artifacts. +attributes used across one or more components of the TAP portfolio and across higher education more generally. It is best thought of as an *attribute library* that can be drawn from to construct other documents, specifications, and software artifacts. -When discussing schema, TAP defines two terms, formatting and protocol, in quite specific ways. +The normative specification of the TAP Attribute Dictionary is an abstract data model -- it must be mapped to specific formats and protocols to be expressed in code. + +TAP uses the word "schema" as a rather broad and loose term for data models generally. However, beyond that, TAP provides careful definitions of two specific schema-related terms, "format" and "protocol". * **Formatting**: Mappings of the TAP Attribute Dictionary entries to a specific markup form, such as JSON, XML, LDAP, or YAML.