fixes to user & role reference docs

(The name of this branch makes no sense -- ignore the name.)