Adjustments to Users Controller DocBlocks

Seems to be fine. Only nit is that all tag descriptions should be treated as sentences, thus first-letter capitals and periods.

We've also been trying to avoid specifying types as 'mixed' unless it's something like a meta value that could accept almost anything. Specificity is almost always preferred. Did I miss anything?