Adjustments to Users Controller DocBlocks

Although the documentation standards don't seem to communicate this, I think the way we already have it is proper WordPress formatting: https://make.wordpress.org/core/handbook/inline-documentation-standards/php-documentation-standards/#1-functions-and-class-methods

cc @DrewAPicture