add REST documentation for principals module

Sure. I was going to ask at standup about combining the existing PRs into one. It's getting painful to switch back and forth between so many different branches.