Update documentation for new user_to_sid functionality

[Andy-Adrian]

The documentation needs to be updated for the refactored user_to_sid function, and the new 'principal' data type.