include notes about roles and role annotations