GIve up artificial primary keys in creation queries

According to Keystone Developer Guide, artificial primary keys must be given in queries while adding a role to user, endpoint to tenant, and so on.
For example, to add a role to user, we must provide something like:
{
"roleRef":{
"id":1,
"roleId":"admin",
"tenantId":"one"
}

"id" is an artificial primary key. In fact, it is autogenerated. So, documentation should be updated.