+1 some reference to "role" in the doc would be cool