added examples and fixed a few more docs

Author: treeben77

docs/source/client.rst

@@ -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)
 

docs/source/index.rst

@@ -6,7 +6,7 @@ Table of Contents
 
 .. toctree::
 
-   :maxdepth: 2
+   :maxdepth: 1
 
    client
    access_token
@@ -17,16 +17,16 @@ Quickstart
 Installing
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-I've finally published the library to PyPi! So now you can use pip.
+You can install the library with pip using this command:
 
 .. code::
 
    pip install discord-oauth2.py
 
-Example With Flask
+Fetching User Data Flask Example
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Don't forget to replace all the client information on line 20 and 21 with your application's own information. You can leave bot token empty if your not adding members to guilds.
+Don't forget to replace all the client information below with your application's own information. You can leave bot token empty if your not adding members to guilds or updating linked roles metadata.
 
 .. code::
    
@@ -49,4 +49,52 @@ Don't forget to replace all the client information on line 20 and 21 with your a
 
       return f"""{identify}<br><br>{connections}<br><br>{guilds}"""
 
+   app.run("0.0.0.0", 8080)
+
+Linked Roles Flask Example
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Don't forget to replace all the client information below with your application's own information.
+
+.. code::
+   
+   import discordoauth2
+   from flask import Flask, request
+   from datetime import datetime
+
+   client = discordoauth2.Client(849930878276993044, secret="very-secret-code",
+   redirect="https://findingfakeurlsisprettyhard.tv/oauth2", bot_token="bot-token-only-required-for-guild-joining")
+
+   client.update_linked_roles_metadata([
+      {
+         "type": 2,
+         "key": "level",
+         "name": "Level",
+         "description": "The user's XP level."
+      },
+      {
+         "type": 6,
+         "key": "join",
+         "name": "Joined",
+         "description": "The date the user joined."
+      },
+      {
+         "type": 7,
+         "key": "supporter",
+         "name": "Supporter",
+         "description": "Wether the user has supported us."
+      }
+   ])
+
+   app = Flask(__name__)
+
+   @app.route("/oauth2")
+   def oauth2():
+      code = request.args.get("code")
+
+      access = client.exchange_code(code)
+      access.update_metadata("Example Game", username="TreeBen77", level=24, join=datetime.now(), supporter=True)
+
+      return f"updated your metadata!"
+
    app.run("0.0.0.0", 8080)