Quick PCX Review part 1

Author: Oxyjun

src/content/docs/hyperdrive/configuration/how-hyperdrive-works.mdx

@@ -15,7 +15,12 @@ Hyperdrive solves these challenges by managing the number of global connections
 
 ## How Hyperdrive makes databases fast globally
 
-Hyperdrive accelerates database queries by performing the connection setup for new database connections near your Workers, pools existing connections near your database, and caches query results.
+Hyperdrive accelerates database queries by:
+
+- Performing the connection setup for new database connections near your Workers
+- Pooling existing connections near your database
+- Caching query results
+
 This ensures you have optimal performance when connecting to your database from Workers (whether your queries are cached or not).
 
 ![Hyperdrive connection](~/assets/images/hyperdrive/configuration/hyperdrive-comparison.svg)

src/content/docs/hyperdrive/configuration/local-development.mdx

@@ -7,13 +7,13 @@ sidebar:
 
 import { WranglerConfig } from "~/components";
 
-Hyperdrive can be used when developing and testing your Workers locally by connecting to a local database instance running on your machine directly or a remote database instance. Local development uses [Wrangler](/workers/wrangler/install-and-update/), the command-line interface for Workers, to manage local development sessions and state.
+Hyperdrive can be used when developing and testing your Workers locally by connecting to a local database instance running on your machine directly, or a remote database instance. Local development uses [Wrangler](/workers/wrangler/install-and-update/), the command-line interface for Workers, to manage local development sessions and state.
 
 :::note[Note]
 
-You can connect to a local development for local development using the local connection string configurations for Wrangler as detailed below. This allows you to connect to a local database instance running on your machine directly.
+You can connect to a local database for local development using the local connection string configurations for Wrangler, as detailed below. This allows you to connect to a local database instance running on your machine directly.
 
-You can also connect to a remote development for local development using the `npx wrangler dev --remote` command, which will use the remote database configured for your Hyperdrive configuration.
+You can also connect to a remote database for remote development using the `npx wrangler dev --remote` command, which will use the remote database configured for your Hyperdrive configuration.
 
 :::
 

src/content/docs/hyperdrive/examples/connect-to-mysql/aws-rds-aurora.mdx

@@ -43,7 +43,7 @@ For regular RDS instances (non-Aurora), you will need to fetch the endpoint and
 2. Select the database you want Hyperdrive to connect to.
 3. Under the **Connectivity & security** header, note down the **Endpoint** and the **Port**.
 
-The endpoint will resemble `YOUR_DATABASE_NAME.cpuo5rlli58m.AWS_REGION.rds.amazonaws.com` and the port will default to `5432`.
+The endpoint will resemble `YOUR_DATABASE_NAME.cpuo5rlli58m.AWS_REGION.rds.amazonaws.com`, and the port will default to `5432`.
 
 :::note[Support for MySQL-compatible providers]
 
@@ -83,7 +83,7 @@ GRANT hyperdrive to hyperdrive_user;
 
 Refer to AWS' [documentation on user roles in PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.PostgreSQL.CommonDBATasks.Roles.html) for more details.
 
-With a database user, password, database endpoint (hostname and port) and database name (default: `postgres`), you can now set up Hyperdrive.
+With a database user, password, database endpoint (hostname and port), and database name (default: `postgres`), you can now set up Hyperdrive.
 
 ## 3. Create a database configuration
 

src/content/docs/hyperdrive/examples/connect-to-mysql/google-cloud-sql.mdx

@@ -33,7 +33,7 @@ To create a user for Hyperdrive to connect as:
 
 1. Select **Users** in the sidebar.
 2. Select **Add User Account** > select **Built-in authentication**.
-3. Provide a name (for example, `hyperdrive-user`) > select **Generate** to generate a password.
+3. Provide a name (for example, `hyperdrive-user`), then select **Generate** to generate a password.
 4. Copy this password to your clipboard before selecting **Add** to create the user.
 
 With the username, password, public IP address and (optional) database name (default: `mysql`), you can now create a Hyperdrive database configuration.

src/content/docs/hyperdrive/examples/connect-to-mysql/index.mdx

@@ -11,7 +11,7 @@ sidebar:
 
 import { TabItem, Tabs, Render, WranglerConfig } from "~/components";
 
-Hyperdrive supports MySQL and MySQL-compatible databases, [popular drivers](#supported-drivers) and Object Relational Mapper (ORM) libraries that use those drivers.
+Hyperdrive supports MySQL and MySQL-compatible databases, [popular drivers](#supported-drivers), and Object Relational Mapper (ORM) libraries that use those drivers.
 
 ## Create a Hyperdrive
 
@@ -21,9 +21,9 @@ New to Hyperdrive? Refer to the [Get started guide](/hyperdrive/get-started/) to
 
 :::
 
-To create a Hyperdrive that connects to an existing MySQL database, use the [wrangler](/workers/wrangler/install-and-update/) CLI or the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers/hyperdrive).
+To create a Hyperdrive that connects to an existing MySQL database, use the [Wrangler](/workers/wrangler/install-and-update/) CLI or the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers/hyperdrive).
 
-When using wrangler, replace the placeholder value provided to `--connection-string` with the connection string for your database:
+When using Wrangler, replace the placeholder value provided to `--connection-string` with the connection string for your database:
 
 ```sh
 # wrangler v3.11 and above required

src/content/docs/hyperdrive/get-started.mdx

@@ -84,9 +84,9 @@ This will create a new `hyperdrive-tutorial` directory. Your new `hyperdrive-tut
 
 ## 3. Connect Hyperdrive to a database
 
-Hyperdrive works by connecting to your database, pooling database connections globally and speeding up your database access through Cloudflare's network.
+Hyperdrive works by connecting to your database, pooling database connections globally, and speeding up your database access through Cloudflare's network.
 
-It will provide a secure connection string that is only accessible from your Worker, that you can use to connect to your database through Hyperdrive.
+It will provide a secure connection string that is only accessible from your Worker which you can use to connect to your database through Hyperdrive.
 This means that you can use the Hyperdrive connection string with your existing drivers or ORM libraries without needing significant changes to your code.
 
 To create your first Hyperdrive database configuration, change into the directory you just created for your Workers project:
@@ -112,7 +112,7 @@ Hyperdrive accepts the combination of these parameters in the common connection
 
     	```
 
-    		Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
+    		Most database providers will provide a connection string you can copy-and-paste directly into Hyperdrive.
 
 To create a Hyperdrive connection, run the `wrangler` command, replacing the placeholder values passed to the `--connection-string` flag with the values of your existing database:
 
@@ -128,7 +128,7 @@ npx wrangler hyperdrive create <YOUR_CONFIG_NAME> --connection-string="postgres:
 
     	```
 
-    		Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
+    		Most database providers will provide a connection string you can copy-and-paste directly into Hyperdrive.
 
     		To create a Hyperdrive connection, run the `wrangler` command, replacing the placeholder values passed to the `--connection-string` flag with the values of your existing database:
 

src/content/docs/hyperdrive/reference/supported-databases-and-features.mdx

@@ -7,7 +7,7 @@ sidebar:
 
 ## Database support
 
-Details on which database engines and/or specific database providers are supported are detailed in the following table.
+The following table shows which database engines and/or specific database providers are supported.
 
 | Database Engine | Supported                | Known supported versions | Details                                                                                  |
 | --------------- | ------------------------ | ------------------------ | ---------------------------------------------------------------------------------------- |

src/content/docs/workers/databases/connecting-to-databases.mdx

@@ -15,9 +15,7 @@ Cloudflare Workers can connect to and query your data in both SQL and NoSQL data
 
 ### D1 SQL database
 
-D1 is Cloudflare's own SQL-based, serverless database. It is optimized for global access from Workers, and can
-scale out with multiple, smaller (10GB) databases, such as per-user, per-tenant or per-entity databases. Similar to some serverless databases,
-D1 pricing is based on query and storage costs.
+D1 is Cloudflare's own SQL-based, serverless database. It is optimized for global access from Workers, and can scale out with multiple, smaller (10GB) databases, such as per-user, per-tenant or per-entity databases. Similar to some serverless databases, D1 pricing is based on query and storage costs.
 
 | Database   | Library or Driver                                                                                                                          | Connection Method                                                                                       |
 | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
@@ -48,6 +46,7 @@ Since a connection must be re-established on every Worker invocation, this adds
 ### Serverless databases
 
 Serverless databases provide HTTP-based proxies and drivers, also known as serverless drivers. These address the lack of connection reuse between Worker invocation similarly to [Hyperdrive](/hyperdrive/) for traditional SQL databases.
+
 By providing a way to query your database with HTTP, these serverless databases and drivers eliminate several roundtrips needed to establish a secure connection.
 
 | Database                                                                                                  | Integration                                                | Library or Driver                                                                  | Connection Method          |
@@ -63,8 +62,7 @@ By providing a way to query your database with HTTP, these serverless databases
 
 :::note[Easier setup with database integrations]
 
-[Database Integrations](/workers/databases/native-integrations/) simplify the authentication for serverless database drivers
-by managing credentials on your behalf and includes support for PlanetScale, Neon and Supabase.
+[Database Integrations](/workers/databases/native-integrations/) simplify the authentication for serverless database drivers by managing credentials on your behalf and includes support for PlanetScale, Neon and Supabase.
 
 If you do not see an integration listed or have an integration to add, complete and submit the [Cloudflare Developer Platform Integration form](https://forms.gle/iaUqLWE8aezSEhgd6).
 

src/content/docs/workers/tutorials/mysql/index.mdx

@@ -18,8 +18,7 @@ In this tutorial, you will learn how to create a Cloudflare Workers application
 
 :::note[Note]
 
-We recommend using [Hyperdrive](/hyperdrive/) to connect to your MySQL database. Hyperdrive provides optimal performance
-and will ensure secure connectivity between your Worker and your MySQL database.
+We recommend using [Hyperdrive](/hyperdrive/) to connect to your MySQL database. Hyperdrive provides optimal performance and will ensure secure connectivity between your Worker and your MySQL database.
 
 When connecting directly to your MySQL database (without Hyperdrive), the MySQL drivers rely on unsupported Node.js APIs to create secure connections, which prevents connections.
 :::
@@ -63,7 +62,7 @@ Now, move into the newly created directory:
 cd mysql-tutorial
 ```
 
-### Enable Node.js compatibility
+## 2. Enable Node.js compatibility
 
 [Node.js compatibility](/workers/runtime-apis/nodejs/) is required for database drivers, including mysql2, and needs to be configured for your Workers project.
 

src/content/partials/hyperdrive/create-hyperdrive-config-mysql.mdx

@@ -17,9 +17,12 @@ Hyperdrive accepts the combination of these parameters in the common connection
 mysql://USERNAME:PASSWORD@HOSTNAME_OR_IP_ADDRESS:PORT/database_name
 ```
 
-Most database providers will provide a connection string you can directly copy-and-paste directly into Hyperdrive.
+Most database providers will provide a connection string you can copy-and-paste directly into Hyperdrive.
 
-To create a Hyperdrive configuration with the [Wrangler CLI](/workers/wrangler/install-and-update/), open your terminal and run the following command. Replace \<NAME_OF_HYPERDRIVE_CONFIG> with a name for your Hyperdrive configuration and paste the connection string provided from your database host, or replace `user`, `password`, `HOSTNAME_OR_IP_ADDRESS`, `port`, and `database_name` placeholders with those specific to your database:
+To create a Hyperdrive configuration with the [Wrangler CLI](/workers/wrangler/install-and-update/), open your terminal and run the following command.
+
+- Replace \<NAME_OF_HYPERDRIVE_CONFIG> with a name for your Hyperdrive configuration and paste the connection string provided from your database host, or,
+- Replace `user`, `password`, `HOSTNAME_OR_IP_ADDRESS`, `port`, and `database_name` placeholders with those specific to your database:
 
 ```sh
 npx wrangler hyperdrive create <NAME_OF_HYPERDRIVE_CONFIG> --connection-string="mysql://user:password@HOSTNAME_OR_IP_ADDRESS:PORT/database_name"