Add some documentation to the UsersController.php

Adds many comment blocks above the functions and explains their usage.
Merge pull request #1 from boboman13/patch-1

Add some documentation to the UsersController.php