Docs tweaks

Author: dannyroosevelt

docs-v2/pages/connect/api.mdx

@@ -85,7 +85,8 @@ export default function Home() {
   const pd = createFrontendClient()
   function connectAccount() {
     pd.connectAccount({
-      app: appSlug,
+      app: appSlug, // Pass the app name slug of the app you want to integrate
+      oauthAppId: appId, // For OAuth apps, pass the OAuth app ID; omit this param to use Pipedream's OAuth client or for key-based apps
       token, // The token you received from your server above
       onSuccess: ({ id: accountId }) => {
         console.log(`Account successfully connected: ${accountId}`)
@@ -95,7 +96,7 @@ export default function Home() {
 
   return (
     <main>
-      <button style={{ all: "revert" }} onClick={connectAccount}>Connect your account</button>
+      <button onClick={connectAccount}>Connect your account</button>
     </main>
   )
 }
@@ -107,7 +108,7 @@ When you use the Connect API, you'll pass an `external_user_id` parameter when i
 
 Pipedream associates this ID with user accounts, so you can retrieve credentials for a specific user, and invoke workflows on their behalf.
 
-External IDs are limited to 250 characters.
+External User IDs are limited to 250 characters.
 
 ## Rate limits
 

docs-v2/pages/connect/index.mdx

@@ -35,17 +35,13 @@ Pipedream Connect lets you build any API integration into your product in minute
 
 Watch [the demo](https://www.youtube.com/embed/xhUagMsogkQ) or visit [the quickstart](/connect/quickstart) to build your first integration.
 
-## App configuration
+## App configuration for OAuth apps
 
-To add a new integration:
+Pipedream has more than {process.env.PUBLIC_APPS} apps available for you to integrate via Connect. Getting started is easy — just follow the [quickstart](/connect/quickstart) to get up and running.
 
-1. Open your project
-2. Click the **Connect** tab
-3. In the **Apps** section, add a new app.
-
-You can add any of Pipedream's [supported apps](https://pipedream.com/apps) to your project, or [request a new app here](https://pipedream.com/support).
+By default, apps that use OAuth to authenticate will use Pipedream's official OAuth client. To deploy your integrations to production, you'll need to configure your own OAuth client. Read more about OAuth clients in Pipedream [here](/connected-accounts/oauth-clients).
 
-When you add an app that uses OAuth to authenticate, you can choose to use either Pipedream's OAuth client (for testing) or [your own OAuth client](/connected-accounts/oauth-clients). If you'd like to use Pipedream OAuth clients in production, please reach out at `[email protected]` or in our [Slack community](https://pipedream.com/support).
+[Let us know](https://pipedream.com/support) if the app you're looking for isn't listed [here](https://pipedream.com/apps).
 
 ## Users
 

docs-v2/pages/connect/oauth-clients.mdx

@@ -12,7 +12,7 @@ There are two types of apps in Pipedream:
 1. **Key-based**: These apps require static credentials, like API keys. Pipedream stores these credentials securely and exposes them via API.
 2. **OAuth**: These apps require OAuth authorization. Pipedream manages the OAuth flow for these apps, ensuring you always have a fresh access token for requests.
 
-**OAuth apps require you create your own OAuth client to [deploy to production](/connect/environments):**
+**OAuth apps require you create your own OAuth client to [deploy Connect to production](/connect/environments):**
 
 <Callout type="info">
 To get started in [development mode](/connect/environments), you can skip these steps. To deploy your app to production, you'll need to [create an OAuth client](#using-a-custom-oauth-client) for the app you're integrating.

docs-v2/pages/connect/quickstart.mdx

@@ -49,6 +49,7 @@ and fill the `.env.local` file with your project and app details:
 # Used by `app/server.ts` to authorize requests to the Pipedream API — see below
 PIPEDREAM_OAUTH_CLIENT_ID=your_client_id
 PIPEDREAM_OAUTH_CLIENT_SECRET=your_client_secret
+PIPEDREAM_PROJECT_ENVIRONMENT=development
 PIPEDREAM_PROJECT_ID=your_project_id
 ```
 
@@ -61,7 +62,7 @@ If you're building your own app, you'll need to provide these values to the envi
 
 ### Create a Pipedream OAuth client
 
-Pipedream uses OAuth to authorize requests to the REST API. To create an OAuth application:
+Pipedream uses OAuth to authorize requests to the REST API. To create an OAuth client:
 
 1. Visit the [API settings](https://pipedream.com/settings/api) for your workspace.
 2. Click the **New OAuth Client** button.
@@ -90,15 +91,15 @@ If you're using a different server / API framework, you'll need to make secure c
 Once you have a token, return it to your frontend to start the account connection flow for the user, or redirect them to a Pipedream-hosted URL with [Connect Link](#use-connect-link).
 
 <Callout type="info">
-Refer to the API docs for [all the parameters you can pass](/connect/api#create-a-new-token) in the `ConnectTokenCreate` call.
+Refer to the API docs for [full set of parameters you can pass](/connect/api#create-a-new-token) in the `ConnectTokenCreate` call.
 </Callout>
 
 ### Connect a user's account
 
 To connect a third-party account for a user, you have two options:
 
 1. [Use the Pipedream SDK](#use-the-pipedream-sdk-in-your-frontend) in your frontend
-2. [Use Connect Link](#use-connect-link) to deliver a hosted URL to your user (see above).
+2. [Use Connect Link](#use-connect-link) to deliver a hosted URL to your user
 
 #### Use the Pipedream SDK in your frontend