update README to reflect actual API
add more details to readme
ensure a proc can be supplied
toggle whether a role is required or not