Write user management documentation

[rethinkdb]

Write user management documentation

[chipotle]

Is there any preliminary documentation from @Tryneus or @deontologician on this yet?

[danielmewes]

There's going to be a special collection (horizon('users')) containing the user data, and probably a shortcut horizon.users for getting the same Collection object.

This is what the contents of that collection might look like:
rethinkdb/horizon#353 (comment)

Every new user is automatically a member of the two groups default and authenticated (though I think you can theoretically remove either of those groups from a user afterwards). As far as permissions are concerned, the default group is also going to match unauthenticated clients, so it can be considered a "catch all" group.

[danielmewes]

Edit: Changed the link to the comment that describes the contents of the users collection to rethinkdb/horizon#353 (comment).

{
  "id": <uuid>, // randomly generated
  "groups": [ "default" ],
  "providers": {
    "google": { /* third-party user profile */ },
    "twitter": { /* third-party user profile */ }
  },
  "data": { /* ... */ }, // (optional) application-specific metadata
}

[chipotle]

In pull request #41