From 20af8f96cb1467f339be6a48735936f4c90c0c8e Mon Sep 17 00:00:00 2001 From: Keith Hazelton Date: Fri, 6 Nov 2020 14:13:02 -0600 Subject: [PATCH] Update README.md --- README.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 481292e..337b693 100644 --- a/README.md +++ b/README.md @@ -3,20 +3,21 @@ ## TAP Attribute Dictionary The [TAP Attribute Dictionary](tap-core-person-schema.adoc) defines a large collection of -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. +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. As additional attributes of utility emerge from ongoing work, they may become new entries in the Attribute Dictionary. -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. +The normative specification of the TAP Attribute Dictionary is an abstract data model -- To be of use in code, it must be mapped to specific formats and protocols. -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, "representation" and "protocol". +TAP uses the word "schema" as a rather broad and loose term for data models generally. However, beyond that, TAP adheres to its own rigorous definitions of two specific schema-related terms, "representation" and "protocol". -* **Representation**: Mappings of the TAP Attribute Dictionary entries to a specific markup form, such as +* **Representation**: Mappings of the TAP Attribute Dictionary abstract entries to a specific markup form, such as JSON, XML, LDAP, or YAML. * [TAP Attribute Dictionary: How to Create a JSON Representation](tap-core-person-schema-create-json-representation.adoc) (CS-JSON) + * Example: "eduPerson LDIF" would refer to eduPerson attributes expressed in the LDIF **Representation** defined in _RFC2849 The LDAP Data Interchange Format (LDIF) - Technical Specification_ -* **Protocol**: A formal specification defining the specific ways two entities interoperate to accomplish a set of actions. Protocols are + +* **Protocol**: A formal specification defining the specific conventions by which two entities interoperate to accomplish a set of actions. Protocols are designed to be implementable in software. + * Example: eduPerson attributes on an LDAP server can be queried by an LDAP client using the LDAP **protocol** defined in _RFC4519 Lightweight Directory Access Protocol (LDAP) Schema for User Applications_ -Example 1: "eduPerson LDIF" would refer to eduPerson attributes expressed in the LDIF **Representation** defined in _RFC2849 The LDAP Data Interchange Format (LDIF) - Technical Specification_ -Example 2: eduPerson attributes on an LDAP server can be queried by an LDAP client using the LDAP **protocol** defined in _RFC4519 Lightweight Directory Access Protocol (LDAP) Schema for User Applications_