feat(users): Add users collection to SDK

docs/users.md

@@ -1,6 +1,8 @@
 # Users
 
-This is a collection of user methods. 
+This is a collection of method that are intended to be helpful wrappers around the [Users api endpoints](user-api-docs).
+
+The definition of the [User response object can be found here](user-object-reference).
 
 ## ToC
 
@@ -13,6 +15,8 @@ This is a collection of user methods.
 ## `sdk.users.me()`
 This method is used to get details about the current logged in user.
 
+**[Documentation](user-get-me)**
+
 ### API
 ```js
 sdk.users.me(): Promise<User>
@@ -36,9 +40,11 @@ sdk.users.me().then((user) => {
 ## `sdk.users.get(id)`
 This method is used to load the details for a specific user by their user id. 
 
+**[Documentation](user-get-id)**
+
 ### API
 ```js
-sdk.users.get(id: number|string): Promise<User>
+sdk.users.get(id: string): Promise<User>
 ```
 
 ### Example
@@ -59,6 +65,8 @@ sdk.users.get(1234567890).then((user) => {
 ## `sdk.users.lookup(email)`
 This method is used to load the details for a specific user by their email address. 
 
+**_Currently, no public documentation page_**
+
 ### API
 ```js
 sdk.users.lookup(email: string): Promise<User>
@@ -75,4 +83,11 @@ const sdk = eventbrite({token: 'OATH_TOKEN_HERE'});
 sdk.users.lookup('[email protected]').then((user) => {
     console.log(`Hi ${user.name}!`);
 });
-```
+```
+
+
+<!-- link reference section -->
+[user-api-docs]: https://www.eventbrite.com/platform/api#/reference/user
+[user-object-reference]: https://www.eventbrite.com/platform/api#/reference/user/retrieve-a-user
+[user-by-id]: https://www.eventbrite.com/platform/api#/reference/user/retrieve-a-user
+[user-get-me]: https://www.eventbrite.com/platform/api#/reference/user/retrieve/retrieve-your-user