Introduce provisional bot API + blanket improvements on docs (#7837)

* introduce provisional bot API + blanket improvements on docs

* tweaks

* Update docs/discord-social-sdk/development-guides/using-provisional-accounts.mdx

Co-authored-by: Mark Mandel <[email protected]>

* Update docs/discord-social-sdk/development-guides/using-provisional-accounts.mdx

Co-authored-by: Mark Mandel <[email protected]>

* Update docs/discord-social-sdk/development-guides/using-provisional-accounts.mdx

Co-authored-by: Mark Mandel <[email protected]>

* Apply suggestions from code review

Co-authored-by: Mark Mandel <[email protected]>

* feedback

* npm run fix:tables

---------

Co-authored-by: Mark Mandel <[email protected]>

Author: spenhand

docs/discord-social-sdk/development-guides/account-linking-with-discord.mdx

@@ -61,7 +61,7 @@ For OAuth2 to work correctly, you must **register the correct redirect URIs** fo
 | **Desktop** | `http://127.0.0.1/callback`                                                                |
 | **Mobile**  | `discord-APP_ID:/authorize/callback` _(replace `APP_ID` with your Discord application ID)_ |
 
-### Step 1: Request Authorization 
+### Step 1: Request Authorization
 
 The SDK provides helper methods to simplify OAuth2 login.
 
@@ -277,6 +277,13 @@ def revoke_token(access_or_refresh_token):
     r.raise_for_status()
 ```
 
+### Handling User Initiated Revocation
+
+Users can unlink their account by removing access to your application on their Discord `User Settings -> Authorized Apps` page.
+
+If you would like to be notified when a user unlinks this way, you can [configure you application to listen for the `APPLICATION_DEAUTHORIZED` webhook event](/docs/events/webhook-events#application-deauthorized).
+Otherwise, you will know that the user has unlinked because their access token and refresh token (if you have one) will be invalidated.
+
 ---
 
 ## Next Steps
@@ -292,7 +299,7 @@ Now that you've successfully implemented account linking with Discord, you can i
   </Card>
   <Card title="Setting Rich Presence" link="/docs/discord-social-sdk/development-guides/setting-rich-presence" icon="UserStatusIcon">
     Display game status and information to Discord friends.
-  </Card>  
+  </Card>
 </Container>
 
 <SupportCallout />
@@ -311,4 +318,4 @@ Now that you've successfully implemented account linking with Discord, you can i
 [`Client::GetDefaultPresenceScopes`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a7648bd1d2f7d9a86ebd0edb8bef12b5c
 [`Client::GetToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#aaee636f91fb1ea3465157c20313b702c
 [`Client::RefreshToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a187af0f99f94b3b9a4ad4302f6a443e7
-[`Client::UpdateToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a606b32cef7796f7fb91c2497bc31afc4
+[`Client::UpdateToken`]: https://discord.com/developers/docs/social-sdk/classdiscordpp_1_1Client.html#a606b32cef7796f7fb91c2497bc31afc4