Add some documentation to the UsersController.php

Adds many comment blocks above the functions and explains their usage.