Documenation fixes for role support and expanded usage examples