Docs for name->id resolution

'(with the reader.....)'  I'd prefer no 'but'. 
How about '...and options for indentifiers of the dependent resources if there are any.'