Update users API Reference documentation
-.. module:: github3
-.. module:: github3.users
+====================================
+ Users and their Associated Objects
+====================================
-User
-====
+This section of the documentation covers the representations of various
+objects related to the `Users API`_.
-This part of the documentation covers:
-- :class:`User <User>`
-- :class:`Key <Key>`
-- :class:`Plan <Plan>`
+User Objects
+------------
-None of these objects should ever be instantiated by the user (developer).
+.. autoclass:: github3.users.ShortUser
+ :inherited-members:
-**When listing users, GitHub only sends a handful of the object's attributes.
-To retrieve all of the object's attributes, you must call the refresh()
-method. This unfortunately requires another call to the API, so use it
-sparingly if you have a low limit**
+.. autoclass:: github3.users.User
+ :inherited-members:
-User Modules
-------------
+.. autoclass:: github3.users.AuthenticatedUser
+ :inherited-members:
-.. autoclass:: User
+.. autoclass:: github3.users.Collaborator
:inherited-members:
-------
+.. autoclass:: github3.users.Contributor
+ :inherited-members:
-.. autoclass:: Key
+
+AuthenticatedUser Peripherals
+-----------------------------
+
+.. autoclass:: github3.users.Key
:inherited-members:
-------
+.. autoclass:: github3.users.Plan
+ :inherited-members:
-.. autoclass:: Plan
+.. autoclass:: github3.users.Email
:inherited-members:
+
+
+.. ---
+.. links
+.. _Users API:
+ https://developer.github.com/v3/users/
