Initial pass at user endpoint documentation.
Move current user docs to after get single user
Add more verbose documentation for /users/me
Document available user data contexts
Slightly reword and rewrap deletion reassign docs
Add missing underscore to WP_User_Query
Note default contexts
Merge pull request #158 from WP-API/docs-user

Add Documentation for User Endpoints.  Closes #158.