add REST documentation for principals module

Certainly could be done. It would be easier for me to do all the modules at the same time since it will require changes to most of them.