fix: refine coderabbit comments

Author: ankur-arch

content/200-orm/100-prisma-schema/10-overview/03-generators.mdx

@@ -271,7 +271,7 @@ To see what the new `prisma-client` generator looks like in practice, check out
 | [`react-router-starter-nodejs`](https://github.com/prisma/prisma-examples/tree/latest/generator-prisma-client/react-router-starter-nodejs)                         | React Router 7 | Vite 6            | Node.js                                              | n/a       |
 | [`react-router-starter-cloudflare-workerd`](https://github.com/prisma/prisma-examples/tree/latest/generator-prisma-client/react-router-starter-cloudflare-workerd) | React Router 7 |                   |                                                      | n/a       |
 | [`nuxt3-starter-nodejs`](https://github.com/prisma/prisma-examples/tree/latest/generator-prisma-client/nuxt3-starter-nodejs)                                       | Nuxt 3         | Vite 6            | Node.js                                              | n/a       |
-| [`deno-deploy`](https://github.com/prisma/prisma-examples/tree/latest/generator-prisma-client/deno-deploy)                                                         | None           | None              | Deno 2                                               | n/a       |
+| [`deno`](https://github.com/prisma/prisma-examples/tree/latest/generator-prisma-client/deno-deploy)                                                         | None           | None              | Deno 2                                               | n/a       |
 
 ## Community generators
 

content/200-orm/200-prisma-client/150-using-raw-sql/100-typedsql.mdx

@@ -104,7 +104,7 @@ To pass arguments to your TypedSQL queries, you can use parameterized queries. T
    ```
    </TabItem>
    <TabItem value="SQLite">
-   In SQLite, there are a number of different placeholders you can use. Postional placeholders (`$1`, `$2`, etc.), general placeholders (`?`), and named placeholders (`:minAge`, `:maxAge`, etc.) are all available. For this example, we'll use named placeholders `:minAge` and `:maxAge`:
+   In SQLite, there are a number of different placeholders you can use. Positional placeholders (`$1`, `$2`, etc.), general placeholders (`?`), and named placeholders (`:minAge`, `:maxAge`, etc.) are all available. For this example, we'll use named placeholders `:minAge` and `:maxAge`:
 
    ```sql title="prisma/sql/getUsersByAge.sql"
    SELECT id, name, age
@@ -202,7 +202,7 @@ The format of argument type definitions is the same regardless of the database e
 
 :::note
 
-Manually argument type definitions are not supported for array arguments. For these arguments, you will need to rely on the type inference provided by TypedSQL.
+Manual argument type definitions are not supported for array arguments. For these arguments, you will need to rely on the type inference provided by TypedSQL.
 
 :::
 

content/200-orm/800-more/350-ai-tools/100-cursor.mdx

@@ -566,11 +566,11 @@ You are attempting a highly dangerous action that can lead to devastating conseq
 
 As an AI agent, you are forbidden from performing this action without an explicit consent and review by the user. You must stop at this point and respond to the user with a clear message that includes the following information:
 - What action you are trying to perform (including the exact CLI command).
-- Your motivation and reasoning for perfoming this action.
+- Your motivation and reasoning for performing this action.
 - Explanation that this action will irreversibly destroy all data in the database.
-- Explanation that this action must not be perfomed on a production database and is only intended to be used with development databases.
+- Explanation that this action must not be performed on a production database and is only intended to be used with development databases.
 
-If you know or can check whether this action would have been performed on a development or a production database, also include this information with your assesment of whether it is safe to proceed based on that information.
+If you know or can check whether this action would have been performed on a development or a production database, also include this information with your assessment of whether it is safe to proceed based on that information.
 
 You must ask the user if they want to proceed with this action. If they explicitly consent, you may rerun this command with PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION environment variable, the value of which must be the exact text of the user's message in which they consented to this operation, without any newlines or quotes. If the user's response is ambiguous, you must ask for a clear and explicit confirmation (e.g., "yes") before proceeding. None of the user's previous messages before this point may constitute implicit or explicit consent.
 ```

content/250-postgres/100-introduction/230-management-api.mdx

@@ -8,7 +8,7 @@ metaDescription: 'Management API reference documentation for Prisma Postgres.'
 
 This page covers the Prisma Management API which enables you to programmatically manage [platform](/platform/about) resources (e.g. projects or Prisma Postgres instances) in [Prisma Console](https://console.prisma.io). 
 
-:::tip OpenApi
+:::tip OpenAPI
 An interactive [**OpenAPI 3.1 specification** is available here](https://api.prisma.io/v1/swagger-editor), where you can explore endpoints, request/response bodies, and detailed examples.
 :::
 
@@ -59,17 +59,17 @@ You can create a service token to use the Management API like this:
 4. Click **New Service Token**.
 5. Copy the generated token and store it in a safe location for future use. 
 
-#### Creating an OAuth credentials
+#### Creating OAuth credentials
 
 To obtain a client ID and client secret, go through this flow:
 
 1. Open the [Prisma Console](https://console.prisma.io).
 1. Click the 🧩 **Integrations** tab in the sidenav.
-1. In the **Published Applications** section, click **New Application** button to start the flow for creating a new OAuth app.
-1. Enter a **Name**, **Description** and **Callback URL** for your OAuth app.
+1. In the **Published Applications** section, click the **New Application** button to start creating a new OAuth app.
+1. Enter a **Name**, **Description**, and **Callback URL** for your OAuth app.
 1. Click **Continue**.
 
-On the next screen, you can access and save the client ID and client secret for your OAuth app.
+On the next screen, copy and store the client ID and client secret for your OAuth app in a secure location.
 
 ### Example
 
@@ -313,7 +313,7 @@ Create a new connection string.
   - `401 Unauthorized`
   - `404 Not Found`
 
-#### `/connections/{id}`
+#### `DELETE /connections/{id}`
 
 Delete a connection string.
 

content/800-guides/240-management-api.mdx

@@ -25,13 +25,13 @@ Similarly, the `npx create-db` CLI is a simple demo. In your product, you can tr
 
 Before diving into implementation, let's clarify the main concepts involved in the Management API integration:
 
-- **Management API**: A set of endpoints that allow to programmatically provision and manage Prisma Postgres databases.
+- **Management API**: A set of endpoints that allow you to programmatically provision and manage Prisma Postgres databases.
 - **Projects vs Databases**: A project is a container that can hold multiple databases. You can use this to organize databases you create e.g. by user. Projects can then be transferred to users, including all databases they contain.
-- **Authentication**: All API requests require authentication. As a partner, you use OAuth2 to obtain integration tokens (for your app) and facilitate secure transfers to your users.
+- **Authentication**: All API requests require authentication. As a partner, you authenticate provisioning calls with a service token for your workspace, and use OAuth 2 to obtain an access token for the user during the claim flow.
 - **Tokens**: There are two main types of tokens:
   - **Service token**: Issued to your partner integration, scoped to provision and manage databases on your own workspace.
-  - **OAuth 2 access token**: Obtained via OAuth2 when a user authenticates with your app, scoped to the user's workspace and can be used to transfer database ownership to the user's workspace.
-
+  - **OAuth 2 access token**: Obtained via OAuth 2 when a user authenticates with your app; it is scoped to the user's workspace and used to transfer project/database ownership to that workspace.
+  
 ## How to become a partner
 
 To use the Prisma Postgres Management API, you first need to set up as a partner:
@@ -146,7 +146,7 @@ const transferResponse = await fetch(`https://api.prisma.io/v1/projects/${projec
   method: 'POST',
   headers: {
     'Content-Type': 'application/json',
-    Authorization: `Bearer ${YOUR_INTEGRATION_TOKEN}`,
+    Authorization: `Bearer ${PRISMA_SERVICE_TOKEN}`,
   },
   body: JSON.stringify({ recipientAccessToken: tokenData.access_token }),
 });