fixes to user & role reference docs