updated to allow filtering by role
added descriptions of possible roles