add REST documentation for principals module

Also, `description`, `managers` and `members` are optional