Creating a resource: "Set the identifier of a resource from the client (e.g. a client-side generated UUID, or a slug)."

[bendavies]

This part of the docs states:

In some cases, you will want to set the identifier of a resource from the client (e.g. a client-side generated UUID, or a slug). In such cases, you must make the identifier property a writable class property. Specifically, to use client-generated IDs, you must do the following:

create a setter for the identifier of the entity (e.g. public function setId(string $id)) or make it a public property ,
add the denormalization group to the property (only if you use a specific denormalization group), and,
if you use Doctrine ORM, be sure to not mark this property with the @GeneratedValue annotation or use the NONE value

But this will always result in Update is not allowed for this operation being thrown here

What am i missing? Are the docs incomplete?

Thanks!

[bendavies]

@soyuka any thoughts please?