add REST documentation for principals module

It's used in following and discussions, IIRC