added short circuit to get_all_role_attributes and updated comments/documentation.