Apply suggestions from code review

Author: Oxyjun

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-database-providers/planetscale.mdx

@@ -30,9 +30,7 @@ With the host, database name, username and password, you can now create a Hyperd
 
 :::note
 
-When connection to a Planetscale database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/)
-to connect directly to the underlying database instead of the [Planetscale serverless driver](https://planetscale.com/docs/tutorials/planetscale-serverless-driver). Hyperdrive is optimized for database access for Workers and
-will perform global connection pooling and fast query routing by connecting directly to your database.
+When connecting to a Planetscale database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/) to connect directly to the underlying database instead of the [Planetscale serverless driver](https://planetscale.com/docs/tutorials/planetscale-serverless-driver). Hyperdrive is optimized for database access for Workers and will perform global connection pooling and fast query routing by connecting directly to your database.
 
 :::
 

src/content/docs/hyperdrive/examples/connect-to-mysql/mysql-drivers-and-libraries/drizzle-orm.mdx

@@ -17,7 +17,7 @@ import { Render } from "~/components";
 - A MySQL database
 - A [Hyperdrive configuration to your MySQL database](/hyperdrive/get-started/#3-connect-hyperdrive-to-a-database)
 
-## Installation
+## 1. Install Drizzle
 
 Install the Drizzle ORM and its dependencies such as the [mysql2](https://github.com/sidorares/node-mysql2) driver:
 
@@ -31,11 +31,11 @@ Add the required Node.js compatibility flags and Hyperdrive binding to your `wra
 
 <Render file="hyperdrive-node-compatibility-requirement" />
 
-## Configure Drizzle
+## 2. Configure Drizzle
 
-### Define a schema
+### 2.1 Define a schema
 
-With Drizzle ORM, we define the schema in TypeScript rather than writing raw SQL. Here's how to define a users table:
+With Drizzle ORM, we define the schema in TypeScript rather than writing raw SQL. Here is how to define a `users` table:
 
 ```ts
 // src/schema.ts
@@ -49,10 +49,9 @@ export const users = mysqlTable("users", {
 });
 ```
 
-### Connect Drizzle ORM to the database with Hyperdrive
+### 2.2 Connect Drizzle ORM to the database with Hyperdrive
 
-Use your the credentials of your Hyperdrive configuration for your database when using the
-Drizzle ORM within your Worker project as such:
+Use your the credentials of your Hyperdrive configuration for your database when using the Drizzle ORM within your Worker project as shown:
 
 ```ts
 // src/db/schema.ts
@@ -86,21 +85,18 @@ export default {
 } satisfies ExportedHandler<Env>;
 ```
 
-### Configure Drizzle-Kit for migrations (optional)
+### 2.3 Configure Drizzle-Kit for migrations (optional)
 
-You can generate and run SQL migrations on your database based on your schema
-using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs/get-started/mysql-new) for additional guidance.
+You can generate and run SQL migrations on your database based on your schema using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs/get-started/mysql-new) for additional guidance.
 
-1.  Create a `.env` file and add your database connection string. The Drizzle Kit CLI will use
-    this connection string to create and apply the migrations.
+1. Create a `.env` file and add your database connection string. The Drizzle Kit CLI will use this connection string to create and apply the migrations.
 
     ```toml
     # Replace with your direct database connection string
     	DATABASE_URL='mysql://user:[email protected]/database-name'
     ```
 
-2.  Create a `drizzle.config.ts` file in the root of your project to configure Drizzle Kit
-    and add the following content:
+2. Create a `drizzle.config.ts` file in the root of your project to configure Drizzle Kit and add the following content:
 
         	```ts
         	import 'dotenv/config';
@@ -115,8 +111,9 @@ using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs
         	});
         	```
 
-3.  Generate the migration file for your database according to your schema files and apply the migrations to your database.
-    `bash
-npx drizzle-kit generate
-npx drizzle-kit migrate
-`
+3. Generate the migration file for your database according to your schema files and apply the migrations to your database.
+
+  ```bash
+  npx drizzle-kit generate
+  npx drizzle-kit migrate
+  ```

src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/neon.mdx

@@ -31,10 +31,7 @@ With both the connection string and the password, you can now create a Hyperdriv
 
 :::note
 
-When connection to a Neon database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/)
-to connect directly to the underlying database
-instead of the [Neon serverless driver](https://neon.tech/docs/serverless/serverless-driver). Hyperdrive is optimized for database access for Workers and
-will perform global connection pooling and fast query routing by connecting directly to your database.
+When connecting to a Neon database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/) to connect directly to the underlying database instead of the [Neon serverless driver](https://neon.tech/docs/serverless/serverless-driver). Hyperdrive is optimized for database access for Workers and will perform global connection pooling and fast query routing by connecting directly to your database.
 
 :::
 

src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-database-providers/supabase.mdx

@@ -34,9 +34,7 @@ With a database user, password, database endpoint (hostname and port) and databa
 
 :::note
 
-When connection to a Supabase database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/)
-to connect directly to the underlying database instead of the [Supabase JavaScript client](https://github.com/supabase/supabase-js). Hyperdrive is optimized for database access for Workers and
-will perform global connection pooling and fast query routing by connecting directly to your database.
+When connecting to a Supabase database with Hyperdrive, you should use a driver like [node-postgres (pg)](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/node-postgres/) or [Postgres.js](/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/postgres-js/) to connect directly to the underlying database instead of the [Supabase JavaScript client](https://github.com/supabase/supabase-js). Hyperdrive is optimized for database access for Workers and will perform global connection pooling and fast query routing by connecting directly to your database.
 
 :::
 

src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/drizzle-orm.mdx

@@ -15,7 +15,7 @@ meta:
 - A PostgreSQL database
 - A [Hyperdrive configuration to your PostgreSQL database](/hyperdrive/get-started/#3-connect-hyperdrive-to-a-database)
 
-## Installation
+## 1. Install Drizzle
 
 Install the Drizzle ORM and its dependencies such as the [postgres](https://github.com/porsager/postgres) driver:
 
@@ -29,11 +29,11 @@ Add the required Node.js compatibility flags and Hyperdrive binding to your `wra
 
 <Render file="hyperdrive-node-compatibility-requirement" />
 
-## Configure Drizzle
+## 2. Configure Drizzle
 
-### Define a schema
+### 2.1 Define a schema
 
-With Drizzle ORM, we define the schema in TypeScript rather than writing raw SQL. Here's how to define a users table:
+With Drizzle ORM, we define the schema in TypeScript rather than writing raw SQL. Here is how to define a `users` table:
 
 ```ts
 // src/db/schema.ts
@@ -47,10 +47,9 @@ export const users = pgTable("users", {
 });
 ```
 
-### Connect Drizzle ORM to the database with Hyperdrive
+### 2.2 Connect Drizzle ORM to the database with Hyperdrive
 
-Use your Hyperdrive configuration for your database when using the
-Drizzle ORM within your Worker project as such:
+Use your Hyperdrive configuration for your database when using the Drizzle ORM within your Worker project as shown:
 
 ```ts
 // src/index.ts
@@ -81,21 +80,18 @@ export default {
 } satisfies ExportedHandler<Env>;
 ```
 
-### Configure Drizzle-Kit for migrations (optional)
+### 2.3 Configure Drizzle-Kit for migrations (optional)
 
-You can generate and run SQL migrations on your database based on your schema
-using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs/get-started/postgresql) for additional guidance.
+You can generate and run SQL migrations on your database based on your schema using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs/get-started/postgresql) for additional guidance.
 
-1.  Create a `.env` file and add your database connection string. The Drizzle Kit CLI will use
-    this connection string to create and apply the migrations.
+1. Create a `.env` file and add your database connection string. The Drizzle Kit CLI will use this connection string to create and apply the migrations.
 
-    ```toml
-    # Replace with your direct database connection string
-    DATABASE_URL='postgres://user:[email protected]/database-name'
-    ```
+   ```toml
+   # Replace with your direct database connection string
+   DATABASE_URL='postgres://user:[email protected]/database-name'
+   ```
 
-2.  Create a `drizzle.config.ts` file in the root of your project to configure Drizzle Kit
-    and add the following content:
+2. Create a `drizzle.config.ts` file in the root of your project to configure Drizzle Kit and add the following content:
 
     ```ts
     import "dotenv/config";
@@ -110,7 +106,8 @@ using Drizzle Kit CLI. Refer to [Drizzle ORM docs](https://orm.drizzle.team/docs
     });
     ```
 
-3.  Generate the migration file for your database according to your schema files and apply the migrations to your database.
+3. Generate the migration file for your database according to your schema files and apply the migrations to your database.
+
     ```bash
     npx drizzle-kit generate
     npx drizzle-kit migrate

src/content/docs/hyperdrive/examples/connect-to-postgres/postgres-drivers-and-libraries/prisma-orm.mdx

@@ -15,7 +15,7 @@ meta:
 - A PostgreSQL database
 - A [Hyperdrive configuration to your PostgreSQL database](/hyperdrive/get-started/#3-connect-hyperdrive-to-a-database)
 
-## Installation
+## 1. Install Prisma
 
 Install Prisma, its dependencies, node-postgres driver, and generate the client:
 
@@ -28,9 +28,9 @@ Add the required Node.js compatibility flags and Hyperdrive binding to your `wra
 
 <Render file="hyperdrive-node-compatibility-requirement" />
 
-## Configure Prisma
+## 2. Configure Prisma
 
-### Define a schema
+### 2.1 Define a schema
 
 With Prisma, we define the schema using the Prisma Schema Language (PSL). Create a `prisma/schema.prisma` file in your project:
 
@@ -63,7 +63,7 @@ After defining your schema, generate the Prisma Client:
 npx prisma generate
 ```
 
-### Connect Prisma to the database with Hyperdrive
+### 2.2 Connect Prisma to the database with Hyperdrive
 
 Use your Hyperdrive configuration for your database when using Prisma with the node-postgres adapter within your Worker project:
 
@@ -122,23 +122,23 @@ export default {
 } satisfies ExportedHandler<Env>;
 ```
 
-### Prisma Migrations (optional)
+### 2.3 Migrate Prisma (optional)
 
 You can use Prisma Migrate to create and manage your database schema:
 
-1.  Create a `.env` file in your project root with your direct database connection string:
-    `toml
-DATABASE_URL='postgresql://user:[email protected]/database-name'
-`
+1. Create a `.env` file in your project root with your direct database connection string:
+   ```toml
+   DATABASE_URL='postgresql://user:[email protected]/database-name'
+   ```
 
-2.  Initialize and generate your first migration (for development only):
-    `sh
-npx prisma migrate dev --name init
-`
+2. Initialize and generate your first migration (for development only):
+   ```sh
+   npx prisma migrate dev --name init
+   ```
 
-            This will create SQL migration files in the `prisma/migrations` directory and apply them to your database.
+   This will create SQL migration files in the `prisma/migrations` directory and apply them to your database.
 
-3.  For production environments, apply migrations without generating new ones:
-    `sh
-npx prisma migrate deploy
-`
+3. For production environments, apply migrations without generating new ones:
+    ```sh
+   npx prisma migrate deploy
+   ```