document does_role($thing, $role)
move `learn` into its own section
move documentation about calling as methods into its own section