add REST documentation for principals module

This should be `BasicPrincipal`