From b45098da7b9fbd81e4f65191374d30254ac5bd91 Mon Sep 17 00:00:00 2001 From: Kalle Tuure Date: Tue, 15 Dec 2015 12:41:18 +0200 Subject: [PATCH] Associate "relationship object" with everything else --- _format/1.0/index.md | 11 ++++++----- _format/1.0/normative-statements.json | 2 +- _format/1.1/index.md | 11 ++++++----- _format/1.1/normative-statements.json | 2 +- 4 files changed, 14 insertions(+), 12 deletions(-) diff --git a/_format/1.0/index.md b/_format/1.0/index.md index eeddf6432..2b8452db2 100644 --- a/_format/1.0/index.md +++ b/_format/1.0/index.md @@ -240,13 +240,14 @@ alongside other information to be represented in a resource object, these keys #### Relationships The value of the `relationships` key **MUST** be an object (a "relationships -object"). Members of the relationships object ("relationships") represent -references from the [resource object][resource objects] in which it's defined to other resource -objects. +object"). Members of the relationships object represent "relationships", i.e., +references from the [resource object][resource objects] in which they are defined +to other resource objects. Relationships may be to-one or to-many. -A "relationship object" **MUST** contain at least one of the following: +Each relationship **MUST** be represented by an object (a "relationship object") +containing at least one of the following: * `links`: a [links object][links] containing at least one of the following: * `self`: a link for the relationship itself (a "relationship link"). This @@ -268,7 +269,7 @@ A relationship object that represents a to-many relationship **MAY** also contai #### Related Resource Links -A "related resource link" provides access to [resource objects] [linked][links] +A "related resource link" provides access to [resource objects][] [linked][links] in a [relationship][relationships]. When fetched, the related resource object(s) are returned as the response's primary data. diff --git a/_format/1.0/normative-statements.json b/_format/1.0/normative-statements.json index 27753ff7b..0f4e3a100 100644 --- a/_format/1.0/normative-statements.json +++ b/_format/1.0/normative-statements.json @@ -643,7 +643,7 @@ layout: null "type": "normative-statements", "attributes": { "level": "MUST", - "description": "A \"relationship object\" **MUST** contain at least one of the following:]\\n\\n- `links`: a links object containing at least one of the following:\\n - `self`: a link for the relationship itself (a \"relationship link\"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an author from an article without deleting the people resource itself.\\n - `related`: a related resource link\\n- `data`: resource linkage\\n- `meta`: a meta object that contains non-standard meta-information about the relationship." + "description": "Each relationship **MUST** be represented by an object (a \"relationship object\") containing at least one of the following:\\n\\n- `links`: a links object containing at least one of the following:\\n - `self`: a link for the relationship itself (a \"relationship link\"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an author from an article without deleting the people resource itself.\\n - `related`: a related resource link\\n- `data`: resource linkage\\n- `meta`: a meta object that contains non-standard meta-information about the relationship." }, "relationships": { "section": { diff --git a/_format/1.1/index.md b/_format/1.1/index.md index b95efc86b..ad415b1f4 100644 --- a/_format/1.1/index.md +++ b/_format/1.1/index.md @@ -240,13 +240,14 @@ alongside other information to be represented in a resource object, these keys #### Relationships The value of the `relationships` key **MUST** be an object (a "relationships -object"). Members of the relationships object ("relationships") represent -references from the [resource object][resource objects] in which it's defined to other resource -objects. +object"). Members of the relationships object represent "relationships", i.e., +references from the [resource object][resource objects] in which they are defined +to other resource objects. Relationships may be to-one or to-many. -A "relationship object" **MUST** contain at least one of the following: +Each relationship **MUST** be represented by an object (a "relationship object") +containing at least one of the following: * `links`: a [links object][links] containing at least one of the following: * `self`: a link for the relationship itself (a "relationship link"). This @@ -268,7 +269,7 @@ A relationship object that represents a to-many relationship **MAY** also contai #### Related Resource Links -A "related resource link" provides access to [resource objects] [linked][links] +A "related resource link" provides access to [resource objects][] [linked][links] in a [relationship][relationships]. When fetched, the related resource object(s) are returned as the response's primary data. diff --git a/_format/1.1/normative-statements.json b/_format/1.1/normative-statements.json index d05f78c6c..dde9bb8fb 100644 --- a/_format/1.1/normative-statements.json +++ b/_format/1.1/normative-statements.json @@ -643,7 +643,7 @@ layout: null "type": "normative-statements", "attributes": { "level": "MUST", - "description": "A \"relationship object\" **MUST** contain at least one of the following:]\\n\\n- `links`: a links object containing at least one of the following:\\n - `self`: a link for the relationship itself (a \"relationship link\"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an author from an article without deleting the people resource itself.\\n - `related`: a related resource link\\n- `data`: resource linkage\\n- `meta`: a meta object that contains non-standard meta-information about the relationship." + "description": "Each relationship **MUST** be represented by an object (a \"relationship object\") containing at least one of the following:\\n\\n- `links`: a links object containing at least one of the following:\\n - `self`: a link for the relationship itself (a \"relationship link\"). This link allows the client to directly manipulate the relationship. For example, it would allow a client to remove an author from an article without deleting the people resource itself.\\n - `related`: a related resource link\\n- `data`: resource linkage\\n- `meta`: a meta object that contains non-standard meta-information about the relationship." }, "relationships": { "section": { pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy