I don't think the issue is with documentation after looking into this briefly, I think the implementation may be the issue and how the roles are exposed. Added a comment here - https://github.com/aerogear/aerogear-android-sdk/issues/103