| rfc9880v5.txt | rfc9880.txt | |||
|---|---|---|---|---|
| skipping to change at line 58 ¶ | skipping to change at line 58 ¶ | |||
| to this document. Code Components extracted from this document must | to this document. Code Components extracted from this document must | |||
| include Revised BSD License text as described in Section 4.e of the | include Revised BSD License text as described in Section 4.e of the | |||
| Trust Legal Provisions and are provided without warranty as described | Trust Legal Provisions and are provided without warranty as described | |||
| in the Revised BSD License. | in the Revised BSD License. | |||
| Table of Contents | Table of Contents | |||
| 1. Introduction | 1. Introduction | |||
| 1.1. Structure of This Document | 1.1. Structure of This Document | |||
| 1.2. Terminology and Conventions | 1.2. Terminology and Conventions | |||
| Programming Platform Terms | 1.2.1. Programming Platform Terms | |||
| Conceptual Terms | 1.2.2. Conceptual Terms | |||
| Specification Language Terms | 1.2.3. Specification Language Terms | |||
| Conventions | 1.2.4. Conventions | |||
| 2. Overview | 2. Overview | |||
| 2.1. Example Definition | 2.1. Example Definition | |||
| 2.2. Elements of an SDF Model | 2.2. Elements of an SDF Model | |||
| 2.2.1. sdfObject | 2.2.1. sdfObject | |||
| 2.2.2. sdfProperty | 2.2.2. sdfProperty | |||
| 2.2.3. sdfAction | 2.2.3. sdfAction | |||
| 2.2.4. sdfEvent | 2.2.4. sdfEvent | |||
| 2.2.5. sdfData | 2.2.5. sdfData | |||
| 2.2.6. sdfThing | 2.2.6. sdfThing | |||
| 2.3. Member Names: Given Names and Quality Names | 2.3. Member Names: Given Names and Quality Names | |||
| skipping to change at line 192 ¶ | skipping to change at line 192 ¶ | |||
| composition in SDF. Finally, Appendix E provides some historical | composition in SDF. Finally, Appendix E provides some historical | |||
| information that can be useful in upgrading earlier, pre-standard SDF | information that can be useful in upgrading earlier, pre-standard SDF | |||
| models and implementations to base SDF. | models and implementations to base SDF. | |||
| 1.2. Terminology and Conventions | 1.2. Terminology and Conventions | |||
| Terms introduced in this section are capitalized when used in this | Terms introduced in this section are capitalized when used in this | |||
| section. To maintain readability, capitalization is only used when | section. To maintain readability, capitalization is only used when | |||
| needed where they are used in the body of this document. | needed where they are used in the body of this document. | |||
| Programming Platform Terms | 1.2.1. Programming Platform Terms | |||
| The following definitions mention terms that are used with specific | The following definitions mention terms that are used with specific | |||
| meanings in various programming platforms, but often have an | meanings in various programming platforms, but often have an | |||
| independent definition for this document, which can be found further | independent definition for this document, which can be found further | |||
| below in this section. | below in this section. | |||
| Element: A generic term used here in its English sense. | Element: A generic term used here in its English sense. | |||
| Exceptionally, in Appendix C, the term is used explicitly in | Exceptionally, in Appendix C, the term is used explicitly in | |||
| accordance with its meaning in the JSON ecosystem, i.e., the | accordance with its meaning in the JSON ecosystem, i.e., the | |||
| elements of JSON arrays. | elements of JSON arrays. | |||
| skipping to change at line 229 ¶ | skipping to change at line 229 ¶ | |||
| Property: Certain environments use the term "property" for a JSON | Property: Certain environments use the term "property" for a JSON | |||
| concept that JSON calls "member" and is called "entry" here, or | concept that JSON calls "member" and is called "entry" here, or | |||
| sometimes just for the map key of these. In this document, the | sometimes just for the map key of these. In this document, the | |||
| term Property is specifically reserved for a certain kind of | term Property is specifically reserved for a certain kind of | |||
| Affordance, even if the map key "properties" is imported with | Affordance, even if the map key "properties" is imported with | |||
| JSON-related semantics from a data definition language. | JSON-related semantics from a data definition language. | |||
| Byte: This document uses the term "byte" in its now-customary sense | Byte: This document uses the term "byte" in its now-customary sense | |||
| as a synonym for "octet". | as a synonym for "octet". | |||
| Conceptual Terms | 1.2.2. Conceptual Terms | |||
| Thing: A physical item that is also available for interaction over a | Thing: A physical item that is also available for interaction over a | |||
| network. | network. | |||
| Element: A part or an aspect of something abstract; i.e., the term | Element: A part or an aspect of something abstract; i.e., the term | |||
| is used here in its usual English definition. | is used here in its usual English definition. | |||
| Affordance: An element of an interface offered for interaction. | Affordance: An element of an interface offered for interaction. | |||
| Such an element becomes an Affordance when information is | Such an element becomes an Affordance when information is | |||
| available (directly or indirectly) that indicates how it can or | available (directly or indirectly) that indicates how it can or | |||
| skipping to change at line 256 ¶ | skipping to change at line 256 ¶ | |||
| Property: An Affordance that can potentially be used to read, write, | Property: An Affordance that can potentially be used to read, write, | |||
| and/or observe state (current/stored information) on a Grouping. | and/or observe state (current/stored information) on a Grouping. | |||
| Action: An Affordance that can potentially be used to perform a | Action: An Affordance that can potentially be used to perform a | |||
| named operation on a Grouping. | named operation on a Grouping. | |||
| Event: An Affordance that can potentially be used to obtain | Event: An Affordance that can potentially be used to obtain | |||
| information about what happened to a Grouping. | information about what happened to a Grouping. | |||
| Specification Language Terms | 1.2.3. Specification Language Terms | |||
| SDF Document: Container for SDF Definitions, together with data | SDF Document: Container for SDF Definitions, together with data | |||
| about the SDF Document itself (information block). Represented as | about the SDF Document itself (information block). Represented as | |||
| a JSON text representing a single JSON map, which is built from | a JSON text representing a single JSON map, which is built from | |||
| nested maps. | nested maps. | |||
| SDF Model: Definitions and declarations that model the digital | SDF Model: Definitions and declarations that model the digital | |||
| interaction opportunities offered by one or more kinds of Things, | interaction opportunities offered by one or more kinds of Things, | |||
| represented by Groupings (sdfObjects and sdfThings). An SDF Model | represented by Groupings (sdfObjects and sdfThings). An SDF Model | |||
| can be fully contained in a single SDF Document, or it can be | can be fully contained in a single SDF Document, or it can be | |||
| skipping to change at line 340 ¶ | skipping to change at line 340 ¶ | |||
| specific Augmentation Mechanisms are defined in base SDF. A | specific Augmentation Mechanisms are defined in base SDF. A | |||
| simple mechanism for such augmentations has been discussed as a | simple mechanism for such augmentations has been discussed as a | |||
| "mapping file" [SDF-MAPPING]. | "mapping file" [SDF-MAPPING]. | |||
| Protocol Binding: A companion document to an SDF Model that defines | Protocol Binding: A companion document to an SDF Model that defines | |||
| how to map the abstract concepts in the model into the protocols | how to map the abstract concepts in the model into the protocols | |||
| that are in use in a specific ecosystem. The Protocol Binding | that are in use in a specific ecosystem. The Protocol Binding | |||
| might supply URL components, numeric IDs, and similar details. | might supply URL components, numeric IDs, and similar details. | |||
| Protocol Bindings are one case of an Augmentation Mechanism. | Protocol Bindings are one case of an Augmentation Mechanism. | |||
| Conventions | 1.2.4. Conventions | |||
| Regular expressions that are used in the text as a "pattern" for some | Regular expressions that are used in the text as a "pattern" for some | |||
| string are interpreted as per [RFC9485]. (Note that a form of | string are interpreted as per [RFC9485]. (Note that a form of | |||
| regular expressions is also used as values of the quality pattern; | regular expressions is also used as values of the quality pattern; | |||
| see Appendix C.2.) | see Appendix C.2.) | |||
| The term "URI" in this document always refers to "full" URIs ("URI" | The term "URI" in this document always refers to "full" URIs ("URI" | |||
| in Section 3 of RFC 3986 [STD66]), never to relative URI references | in Section 3 of RFC 3986 [STD66]), never to relative URI references | |||
| ("relative-ref" in Section 4.1 of RFC 3986 [STD66]), so the term | ("relative-ref" in Section 4.1 of RFC 3986 [STD66]), so the term | |||
| "URI" does _NOT_ serve as the colloquial abbreviation of "URI- | "URI" does _NOT_ serve as the colloquial abbreviation of "URI- | |||
| End of changes. 5 change blocks. | ||||
| 8 lines changed or deleted | 8 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. | ||||