From 68007c1ebda15d99cacd261d3104119be97547b1 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Fri, 4 Sep 2020 15:06:13 +0200 Subject: [PATCH 1/7] Add payload and representations in RDF --- main/resource-access.bs | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/main/resource-access.bs b/main/resource-access.bs index 999484d8..0f37216e 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -279,6 +279,20 @@ Issue: Pertaining to events and loss of control mitigation: https://github.com/solid/specification/issues/41#issuecomment-534679278 +### Representations ### {#representations} + +When a server creates a resource on HTTP `PUT`, `POST` or `PATCH` requests +such that the request's representation data encodes an *RDF document* +[[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server +MUST respect `GET` requests on this resource when the value of the `Accept` +header requests a response in `text/turtle` or `application/ld+json`, unless +HTTP content negotiation requires a different outcome. + +[[Source](https://github.com/solid/specification/issues/45)] +[[Source](https://github.com/solid/specification/issues/69)] +[[Source](https://github.com/solid/specification/issues/109)] +[[Source](https://github.com/solid/specification/issues/195)] + ## Auxiliary Resources ## {#rm} ### Background and Need ### {#ar-need} From 854fca6c3b3f73a238487cab8e0b992fabda40c4 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Sat, 5 Sep 2020 16:40:05 +0200 Subject: [PATCH 2/7] Simplify Accept header wording --- main/resource-access.bs | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 0f37216e..61f72fcf 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -285,8 +285,7 @@ When a server creates a resource on HTTP `PUT`, `POST` or `PATCH` requests such that the request's representation data encodes an *RDF document* [[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server MUST respect `GET` requests on this resource when the value of the `Accept` -header requests a response in `text/turtle` or `application/ld+json`, unless -HTTP content negotiation requires a different outcome. +header requests a representation in `text/turtle` or `application/ld+json`. [[Source](https://github.com/solid/specification/issues/45)] [[Source](https://github.com/solid/specification/issues/69)] From 851eb01c1aa6359431f70fa9fd6ac1fdc0b11f18 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Sat, 5 Sep 2020 18:20:21 +0200 Subject: [PATCH 3/7] Add write operation targeting representation URL --- main/resource-access.bs | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 61f72fcf..954175d3 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -286,12 +286,17 @@ such that the request's representation data encodes an *RDF document* [[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server MUST respect `GET` requests on this resource when the value of the `Accept` header requests a representation in `text/turtle` or `application/ld+json`. - [[Source](https://github.com/solid/specification/issues/45)] [[Source](https://github.com/solid/specification/issues/69)] [[Source](https://github.com/solid/specification/issues/109)] [[Source](https://github.com/solid/specification/issues/195)] +When a `PUT`, `POST`, `PATCH` or `DELETE` method request targets a resource's +representation URL, the server MUST respond with a `307` or `308` status code +and `Location` header specifying the preferred URI reference. +[[Source](https://github.com/solid/specification/issues/109)] + + ## Auxiliary Resources ## {#rm} ### Background and Need ### {#ar-need} From 2e39b8b764ac9236840b3c2e6ac0566a14c8f284 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Sun, 6 Sep 2020 22:02:54 +0200 Subject: [PATCH 4/7] Add references to Turtle, JSON-LD --- main/resource-access.bs | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 954175d3..543e575f 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -285,7 +285,8 @@ When a server creates a resource on HTTP `PUT`, `POST` or `PATCH` requests such that the request's representation data encodes an *RDF document* [[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server MUST respect `GET` requests on this resource when the value of the `Accept` -header requests a representation in `text/turtle` or `application/ld+json`. +header requests a representation in `text/turtle` or `application/ld+json` +[[!Turtle]] [[!JSON-LD]]. [[Source](https://github.com/solid/specification/issues/45)] [[Source](https://github.com/solid/specification/issues/69)] [[Source](https://github.com/solid/specification/issues/109)] From 61afa786123976b67e7dfcbd6a1a133919397ce5 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Sun, 6 Sep 2020 22:04:41 +0200 Subject: [PATCH 5/7] Refer to JSON-LD 1.1 instead of JSON-LD 1.0 --- main/resource-access.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 543e575f..2886b070 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -286,7 +286,7 @@ such that the request's representation data encodes an *RDF document* [[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server MUST respect `GET` requests on this resource when the value of the `Accept` header requests a representation in `text/turtle` or `application/ld+json` -[[!Turtle]] [[!JSON-LD]]. +[[!Turtle]] [[!JSON-LD11]]. [[Source](https://github.com/solid/specification/issues/45)] [[Source](https://github.com/solid/specification/issues/69)] [[Source](https://github.com/solid/specification/issues/109)] From 658dc4c6d7f821260d587ad7dc5d6482ee48e1e3 Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Wed, 9 Sep 2020 07:52:56 +0200 Subject: [PATCH 6/7] Try s/respect/accept ie. to honour, conform to, follow through. A success --- main/resource-access.bs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 2886b070..2cd0f230 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -284,7 +284,7 @@ https://github.com/solid/specification/issues/41#issuecomment-534679278 When a server creates a resource on HTTP `PUT`, `POST` or `PATCH` requests such that the request's representation data encodes an *RDF document* [[!RDF11-CONCEPTS]] (as determined by the `Content-Type` header), the server -MUST respect `GET` requests on this resource when the value of the `Accept` +MUST accept `GET` requests on this resource when the value of the `Accept` header requests a representation in `text/turtle` or `application/ld+json` [[!Turtle]] [[!JSON-LD11]]. [[Source](https://github.com/solid/specification/issues/45)] From e92d8bce5caaad42fcaad465ba326e44fc1357fc Mon Sep 17 00:00:00 2001 From: Sarven Capadisli Date: Mon, 21 Sep 2020 16:37:41 +0200 Subject: [PATCH 7/7] Clarify redirect criteria for write request to representation URL --- main/resource-access.bs | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/main/resource-access.bs b/main/resource-access.bs index 2cd0f230..5000d954 100644 --- a/main/resource-access.bs +++ b/main/resource-access.bs @@ -292,9 +292,10 @@ header requests a representation in `text/turtle` or `application/ld+json` [[Source](https://github.com/solid/specification/issues/109)] [[Source](https://github.com/solid/specification/issues/195)] -When a `PUT`, `POST`, `PATCH` or `DELETE` method request targets a resource's -representation URL, the server MUST respond with a `307` or `308` status code -and `Location` header specifying the preferred URI reference. +When a `PUT`, `POST`, `PATCH` or `DELETE` method request targets a +representation URL that is different than the resource URL, the server MUST +respond with a `307` or `308` status code and `Location` header specifying the +preferred URI reference. [[Source](https://github.com/solid/specification/issues/109)]