Docs for name->id resolution

`works under the following conditions`