updated docs once again

Author: treeben77

docs/source/access_token.rst

@@ -96,7 +96,7 @@ AccessToken
       :param bool mute: Wether they should be server muted when they join.
       :param bool deaf: Wether they should be server deafend when they join.
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.join scope or the bot isn't in the guild/have the correct permissions.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -111,7 +111,7 @@ AccessToken
 
       .. versionadded:: 1.1
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -126,7 +126,7 @@ AccessToken
       :param str platform_username: Text that appears under the platform name, large, and usally denoting the user's name on the platform.
       :param dict metadata: List of keys and values to set the user's metadata. Supported types: :class:`bool`, :class:`datetime.datetime`, :class:`int`
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -141,7 +141,7 @@ AccessToken
 
       .. versionadded:: 1.1
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -184,7 +184,7 @@ AccessToken
 
       Returns a dictionary with a `user object <https://discord.com/developers/docs/resources/user#user-object-user-structure>`__ which includes ``email`` and ``verified`` (verified email) if the ``email`` scope is provided
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the identify scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -193,7 +193,7 @@ AccessToken
 
       Returns a list of `connection objects <https://discord.com/developers/docs/resources/user#connection-object-connection-structure>`__
 
-      :returns: :class:`list`
+      :returns: list[dict]
       :raises discordoauth2.exceptions.HTTPException: The request failed
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the connections scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -203,7 +203,7 @@ AccessToken
 
       Returns a list of partial `guild objects <https://discord.com/developers/docs/resources/guild#guild-object>`__
 
-      :returns: :class:`list`
+      :returns: list[dict]
       :raises discordoauth2.exceptions.HTTPException: The request failed
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -214,7 +214,7 @@ AccessToken
 
       :param int guild_id: The guild ID to retrieve member data from.
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -229,7 +229,7 @@ AccessToken
       :param bool mute: Wether they should be server muted when they join.
       :param bool deaf: Wether they should be server deafend when they join.
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.join scope or the bot isn't in the guild/have the correct permissions.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -240,7 +240,7 @@ AccessToken
 
       .. versionadded:: 1.1
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -255,7 +255,7 @@ AccessToken
       :param str platform_username: Text that appears under the platform name, large, and usally denoting the user's name on the platform.
       :param dict metadata: List of keys and values to set the user's metadata. Supported types: :class:`bool`, :class:`datetime.datetime`, :class:`int`
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.
@@ -270,7 +270,7 @@ AccessToken
 
       .. versionadded:: 1.1
 
-      :returns: :class:`dict`
+      :returns: dict
       :raises discordoauth2.exceptions.HTTPException: The request failed, possibly because the member is not in the guild.
       :raises discordoauth2.exceptions.Forbidden: The AccessToken doesn't have the guilds.member.read scope.
       :raises discordoauth2.exceptions.RateLimited: You're being rate limited.

docs/source/client.rst

@@ -12,7 +12,7 @@ Client
 
    .. attribute:: id 
 
-      The application ID
+      The application's ID
 
       :type: int
 
@@ -42,7 +42,7 @@ Client
 
    .. method:: refresh_token(refresh_token)
 
-      Converts a refresh token into a new `AccessToken`. You should store the refresh token and access token, so you can renew the access token when it expires.
+      Converts a refresh token into a new :class:`discordoauth2.AccessToken`. You should store the refresh token and access token, so you can renew the access token when it expires.
 
       :param str refresh_token: The refresh token, can be found from :attr:`discordoauth2.AccessToken.refresh_token`
 
@@ -52,7 +52,7 @@ Client
 
    .. method:: client_credentails_grant(scope)
 
-      Creates an `AccessToken` on behalf of the application's owner.
+      Creates an :class:`discordoauth2.AccessToken` on behalf of the application's owner.
 
       :param list[str] scope: List of scopes.
 
@@ -62,7 +62,7 @@ Client
 
    .. warning::
 
-      If the application is owned by a team, you can only request for the `identify` scope. You can also request `applications.commands.update`, but the library does not support it yet.
+      If the application is owned by a team, you can only request for the ``identify`` scope. You can also request ``applications.commands.update`, but the library does not support it yet.``
 
    .. method:: revoke_token(token, token_type=None)
 
@@ -82,7 +82,7 @@ Client
 
       .. versionadded:: 1.1
 
-      :param dict metadata: Should be a list of `application role connection metadata<https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object>`__
+      :param dict metadata: Should be a list of `application role connection metadata <https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object>`__
 
    .. note::
 

docs/source/index.rst

@@ -6,6 +6,8 @@ Table of Contents
 
 .. toctree::
 
+   :maxdepth: 2
+
    client
    access_token