Rework Overview

docs/premium_apps/App_Subscriptions.md

@@ -1,21 +1,18 @@
-# Adding A Subscription to Your App
+# App Subscriptions
 
-## Overview
+App Subscriptions are **TODO TODO TODO**. Before you can add an app subscription to your app, you must complete the [Monetization Eligibility Checklist](#DOCS_PREMIUM_APPS_OVERVIEW/eligibility-checklist)
 
-Before you can add monetization to your app, you must:
+Once you've confirmed eligibility for your app and team, you will be able to set up a [SKU](#DOCS_PREMIUM_APPS_SKUS) to represent your app's premium offering.
 
-1. Have a verified app
-2. Complete the [Monetization Eligibility Checklist](#DOCS_PREMIUM_APPS_OVERVIEW/eligibility-checklist)
+## Types of Subscriptions
 
-Once you've confirmed eligibility for your app and team, you will be able to set up a SKU to represent your app's premium offering.
+When creating subscriptions, you will need to choose between user or guild subscriptions:
 
-## Deciding on Subscription Type
-
-You will need to choose between offering subscriptions to specific users or guilds for your app. You cannot offer both. Currently, you can only have one published subscription SKU for your app. This choice will impact what users have access to your app's premium features:
-
--   **User Subscriptions**: Offers premium features to an individual user across any server they have your app installed in.
+-   **User Subscriptions**: Offers premium features to an individual user across any server where your app installed.
 -   **Guild Subscriptions**: Provides premium benefits to all members within a specific server.
 
+Currently, you can only have one published subscription SKU for your app, so you cannot offer both types of subscriptions.
+
 ## Requiring a Subscription for Specific Application Commands
 
 Let's pretend we have an app called RSSNelly.

docs/premium_apps/Overview.md

@@ -1,36 +1,21 @@
 # Premium Apps
 
-## Getting Started with Premium Apps
+Premium Apps is a set of monetization features for apps on Discord that allows developers to:
 
-Premium Apps are a new set of monetization features for developers on Discord. Using Premium Apps, you can:
-
--   Sell monthly recurring subscriptions to your app directly on Discord
--   Highlight your premium benefits on the App Directory
+-   Sell monthly recurring [subscriptions](#DOCS_PREMIUM_APPS_APP_SUBSCRIPTIONS) for your app's premium functionality within Discord
+-   Highlight your app's premium benefits on the App Directory
 -   Offer native product tie-ins and upsells on the App Directory, app profiles, and in chat
 
 ![Premium App screenshot](premium-example.png)
 
-Currently, there are two types of subscriptions you can offer to users:
-
--   **User Subscriptions**: A subscription purchased by a user for themselves. They get access to your premium benefits in every server
--   **Guild Subscriptions**: A subscription purchased by a user and applied to a single server. Everyone in that server gets your premium benefits
-
-Adding monetization to your app is a three-step process:
-
-1. Getting your application and team set up to offer subscriptions
-2. Creating and customizing a SKU for your subscription
-3. Adding support for SKUs and Entitlements to your app
-
-# Application and Team Setup
-
 ## Eligibility Checklist
 
-Before you can start creating SKUs and offering subscriptions to your app, we need to make sure your app and team are set up correctly to accept payments.
+Before you can start creating SKUs and offering subscriptions for your app, your app and team must be eligible for monetization.
 
-The onboarding flow involves a series of steps and checks that the team owner will ensure are completed. Onboarding checks will be made to ensure the following criteria are met:
+Only team owners can enable monetization for an app. When a team owner enables monetization, they'll be taken through a series of steps and checks to ensure the following criteria are met:
 
 -   App must be verified
--   App belongs to a Developer Team
+-   App belongs to a developer team
 -   Team member(s) must be at least 18 years old
 -   Team must have verified emails and 2FA set up
 -   App uses slash commands, or has been approved for the Message Content privileged intent
@@ -42,36 +27,37 @@ The onboarding flow involves a series of steps and checks that the team owner wi
 -   Payouts must be setup with a valid payment method
 -   Agreement to the [Monetization Terms](https://support.discord.com/hc/en-us/articles/5330075836311) and [Discord App Subscriptions Policy](https://support-dev.discord.com/hc/en-us/articles/17442400631959).
 
-![Eligibility Checklist](monetization.png)
+## Setting Up Monetization
 
-### Setting up Your App with a Team
+Adding monetization to your app is a three-step process:
+
+1. Set up your app and developer team to offer subscriptions
+2. Create and customize a SKU for your app subscription
+3. Adding support for SKUs and Entitlements to your app
 
-You'll need:
+### Configuring Your App
 
--   A team in the developer portal. If you don't have one, [create one here](https://discord.com/developers/teams)
--   A verified application _owned by that team_
--   A test application _owned by that team_
+Before monetization can be enabled, you will need:
 
-If your application is verified, but not owned by a team, you can request owner transfership via Discord's Developer Support by:
+-   A [team](#DOCS_TOPICS_TEAMS) in the developer portal. If you don't have one, you can [create one on the Teams page](https://discord.com/developers/teams)
+-   A [verified app](https://support.discord.com/hc/en-us/articles/360040720412-Bot-Verification-and-Data-Allowlisting#h_46b3869c-6d50-43fc-b07c-9ed7569a1160) that is _owned by that team_
+-   A test app _owned by that team_
 
--   Going to [https://dis.gd/contact](https://dis.gd/contact)
--   Selecting "Developer Support" from the list of options
--   Selecting "Teams and Ownership"
--   Completing the transfer process
+If your app is verified, but not owned by a team, you can request an owner transfership by reaching out to [developer support](https://support-dev.discord.com/hc/en-us/requests/new?ticket_form_id=12094720423319) and under **What can we help you with?**, select "Teams and Ownership".
 
----
+### Setting Up Team Payouts
 
-## Setting Up Payouts
+In the meantime, you can begin setting up your payout information so you can get paid! Discord does all payout processing through Stripe, so part of setting up payouts will be going through Stripe's onboarding flow.
 
-In the meantime, you can begin setting up your payout information, so you can get paid! Discord does all payout processing through Stripe.
+Only the owner of the team can enable payout settings for the team.
 
-**IF YOU ARE A DEVELOPER BASED IN THE UNITED STATES**
+#### If You are Based in the United States
 
--   Go to your team in the Developer Portal
+-   Click on [your team](https://discord.com/developers/teams) on the Teams page.
 -   Select "Payout Settings"
-    -   If you do not see "Payout Settings", you are not the owner of the team. Only the owner of the team can enable Payout Settings
+    -   If you do not see "Payout Settings", you are not the owner of the team. Only the owner of the team can enable payout settings for the team.
 -   Complete the onboarding flow through Stripe
 
-**IF YOU ARE A DEVELOPER BASED OUTSIDE OF THE UNITED STATES**
+#### If You are Based Outside of the United States
 
--   Premium Apps is not yet available outside of the United States. These features will be made available to more regions soon.
+Premium Apps is not currently available outside of the United States. These features will be made available to more regions soon.

docs/premium_apps/SKUs.md

@@ -1,6 +1,6 @@
 ## SKU Resource
 
-SKUs in Discord represent premium offerings that can be made available to your application's users or guilds.
+SKUs (stock-keeping units) in Discord represent premium offerings that can be made available to your application's users or guilds.
 
 ### SKU Object