doc: clarify wording around 204 for POST (#1481)

verdie-g · web-flow · commit fe957673dd9a · 2024-02-26T10:20:43.000+01:00
* doc: clarify wording around 204 for POST

* Update creating.md
diff --git a/docs/usage/writing/creating.md b/docs/usage/writing/creating.md
@@ -16,8 +16,8 @@ POST /articles HTTP/1.1
 }
 ```
 
-When using client-generated IDs and only attributes from the request have changed, the server returns `204 No Content`.
-Otherwise, the server returns `201 Created`, along with the updated resource and its newly assigned ID.
+When using client-generated IDs and all attributes of the created resource are the same as in the request, the server
+returns `204 No Content`. Otherwise, the server returns `201 Created`, along with the stored attributes and its newly assigned ID.
 
 In both cases, a `Location` header is returned that contains the URL to the new resource.
 

Original file line number	Diff line number	Diff line change
`@@ -16,8 +16,8 @@ POST /articles HTTP/1.1`
`16`	`16`	`}`
`17`	`17`	```
`18`	`18`
`19`		-When using client-generated IDs and only attributes from the request have changed, the server returns `204 No Content`.
`20`		-Otherwise, the server returns `201 Created`, along with the updated resource and its newly assigned ID.
	`19`	`+When using client-generated IDs and all attributes of the created resource are the same as in the request, the server`
	`20`	+returns `204 No Content`. Otherwise, the server returns `201 Created`, along with the stored attributes and its newly assigned ID.
`21`	`21`
`22`	`22`	In both cases, a `Location` header is returned that contains the URL to the new resource.
`23`	`23`