update roles use of api with test and docs

Note: The roles test does not work completely since changing user is not working. Unsure how to accomplish this. Tests run as admin do work.
Merge pull request #55 from thomasmckay/roles

update roles use of api with test and docs