thomasgauvin: make node-postgres recommendation more prevalent (#26419)

Author: thomasgauvin

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

@@ -1,5 +1,4 @@
 ---
-
 hideChildren: false
 pcx_content_type: concept
 title: Connect to PostgreSQL
@@ -44,7 +43,7 @@ Hyperdrive uses Workers [TCP socket support](/workers/runtime-apis/tcp-sockets/#
 
 | Driver                                                     | Documentation                                                            | Minimum Version Required | Notes                                                                                                                                                                                                                                                                                |
 | ---------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| node-postgres - `pg`      (recommended)                                 | [node-postgres - `pg` documentation](https://node-postgres.com/)         | `[email protected]`              | `8.11.4` introduced a bug with URL parsing and will not work. `8.11.5` fixes this. Requires `compatibility_flags = ["nodejs_compat"]` and `compatibility_date = "2024-09-23"` - refer to [Node.js compatibility](/workers/runtime-apis/nodejs). Requires wrangler `3.78.7` or later. |
+| node-postgres - `pg` (recommended)                         | [node-postgres - `pg` documentation](https://node-postgres.com/)         | `[email protected]`              | `8.11.4` introduced a bug with URL parsing and will not work. `8.11.5` fixes this. Requires `compatibility_flags = ["nodejs_compat"]` and `compatibility_date = "2024-09-23"` - refer to [Node.js compatibility](/workers/runtime-apis/nodejs). Requires wrangler `3.78.7` or later. |
 | Postgres.js                                                | [Postgres.js documentation](https://github.com/porsager/postgres)        | `[email protected]`         | Supported in both Workers & Pages.                                                                                                                                                                                                                                                   |
 | Drizzle                                                    | [Drizzle documentation](https://orm.drizzle.team/)                       | `0.26.2`^                |                                                                                                                                                                                                                                                                                      |
 | Kysely                                                     | [Kysely documentation](https://kysely.dev/)                              | `0.26.3`^                |                                                                                                                                                                                                                                                                                      |
@@ -54,6 +53,8 @@ Hyperdrive uses Workers [TCP socket support](/workers/runtime-apis/tcp-sockets/#
 
 Other drivers and ORMs not listed may also be supported: this list is not exhaustive.
 
+<Render file="node-postgres-recommendation" product="hyperdrive" />
+
 ### Database drivers and Node.js compatibility
 
 [Node.js compatibility](/workers/runtime-apis/nodejs/) is required for database drivers, including Postgres.js, and needs to be configured for your Workers project.

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

@@ -11,4 +11,6 @@ import { Render } from "~/components";
 
 [node-postgres](https://node-postgres.com/) (pg) is a widely-used PostgreSQL driver for Node.js applications. This example demonstrates how to use node-postgres with Cloudflare Hyperdrive in a Workers application.
 
+<Render file="node-postgres-recommendation" product="hyperdrive" />
+
 <Render file="use-node-postgres-to-make-query" product="hyperdrive" />

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

@@ -11,4 +11,6 @@ import { Render } from "~/components";
 
 [Postgres.js](https://github.com/porsager/postgres) is a modern, fully-featured PostgreSQL driver for Node.js. This example demonstrates how to use Postgres.js with Cloudflare Hyperdrive in a Workers application.
 
+<Render file="node-postgres-recommendation" product="hyperdrive" />
+
 <Render file="use-postgres-js-to-make-query" product="hyperdrive" />

src/content/partials/hyperdrive/node-postgres-recommendation.mdx

@@ -0,0 +1,9 @@
+---
+{}
+---
+
+:::note[Recommended driver]
+
+[Node-postgres](https://node-postgres.com/) (`pg`) is the recommended driver for connecting to your Postgres database from JavaScript or TypeScript Workers. It has the best compatibility with Hyperdrive's caching and is commonly available with popular ORM libraries. [Postgres.js](https://github.com/porsager/postgres) is also supported.
+
+:::