UserPreferences

PaceDontRepeatMemberIRI


Abstract

Modify section 9.2 slightly to avoid encouraging duplicate return of the Member IRI

Status

open

Rationale

Creating a new resource with POST encourages returning the Member IRI in two places, the Location header and the link@rel="edit" in the POST response body. On the principle of Don't Repeat Yourself, while this should not be forbidden, it should not be encouraged.

Proposal

Change the third para of 9.2 to read

When the server generates a response with a status code of 201 ("Created"), it SHOULD also return a response body, which if provided, MUST be an Atom Entry Document representing the newly-created resource.

(Editors may want to then combine this now-very-short para with the next)

Impacts

Slight simplification.

Notes