Change notes and mentions of node compat v2 (cloudflare#19079)

ToriLindsay · web-flow · commit dee6e8f500b7 · 2025-01-10T16:03:29.000Z
* Change notes and mentions of node compat v2

* Fixing the failed check

* Update src/content/docs/browser-rendering/platform/wrangler.mdx

* Update src/content/docs/browser-rendering/platform/wrangler.mdx

* Update src/content/docs/browser-rendering/platform/wrangler.mdx

* to fix failed check

* Update src/content/docs/browser-rendering/platform/wrangler.mdx
diff --git a/src/content/docs/browser-rendering/platform/wrangler.mdx b/src/content/docs/browser-rendering/platform/wrangler.mdx
@@ -5,6 +5,8 @@ sidebar:
   order: 20
 ---
 
+import { Render, WranglerConfig } from "~/components"
+
 [Wrangler](/workers/wrangler/) is a command-line tool for building with Cloudflare developer products.
 
 Use Wrangler to deploy projects that use the Workers Browser Rendering API.
@@ -19,12 +21,7 @@ To install Wrangler, refer to [Install and Update Wrangler](/workers/wrangler/in
 
 To deploy a Browser Rendering Worker, you must declare a [browser binding](/workers/runtime-apis/bindings/) in your Worker's `wrangler.toml` configuration file.
 
-:::note[Wrangler configuration]
-
-If you are using [Puppeteer](/browser-rendering/platform/puppeteer/) in your Worker code, then you also need to add "nodejs_compat_v2" to the compatibility_flags in your Worker's `wrangler.toml` configuration. More information [here](/workers/runtime-apis/nodejs/#enable-nodejs-with-workers), including for [pages functions](/workers/runtime-apis/nodejs/#enable-nodejs-with-pages-functions).
-:::
-
-import { WranglerConfig } from "~/components";
+<Render file="nodejs-compat-howto" product="workers" />
 
 <WranglerConfig>
 
diff --git a/src/content/docs/workers/tutorials/generate-dynamic-og-images-using-workers/index.mdx b/src/content/docs/workers/tutorials/generate-dynamic-og-images-using-workers/index.mdx
@@ -214,7 +214,7 @@ minify = true
 watch_dir = "public"
 ```
 
-The `nodejs_compat_v2` flag enables runtime compatibility features required by the OG image generation library, even when using Bun. While we're using Bun as our development runtime, this flag ensures all necessary APIs are available in the Workers environment. The `assets` configuration maps your Worker's public directory, allowing direct access to static files like fonts, images, and favicons through URL paths (for example, `/fonts/Inter.ttf`, `/images/logo.png`).
+[The `nodejs_compat` flag](/workers/configuration/compatibility-flags/#nodejs-compatibility-flag) enables runtime compatibility features required by the OG image generation library, even when using Bun. While we're using Bun as our development runtime, this flag ensures all necessary APIs are available in the Workers environment. The `assets` configuration maps your Worker's public directory, allowing direct access to static files like fonts, images, and favicons through URL paths (for example, `/fonts/Inter.ttf`, `/images/logo.png`).
 
 ## 4. Configure font loading strategies
 
diff --git a/src/content/docs/workers/tutorials/postgres/index.mdx b/src/content/docs/workers/tutorials/postgres/index.mdx
@@ -58,8 +58,7 @@ cd postgres-tutorial
 
 ### Enable Node.js compatibility
 
-When creating your Worker application, [enable Node.js APIs](/workers/runtime-apis/nodejs/#enable-nodejs-with-workers) by including the
-"nodejs_compat_v2" compatibility flag to your `wrangler.toml`. This will be needed to use the library to connect to your PostgreSQL database.
+<Render file="nodejs-compat-howto" />
 
 import { WranglerConfig } from "~/components";
 
diff --git a/src/content/docs/workers/wrangler/configuration.mdx b/src/content/docs/workers/wrangler/configuration.mdx
@@ -171,7 +171,7 @@ At a minimum, the `name`, `main` and `compatibility_date` keys are required to d
 
 - `node_compat` <Type text="boolean" /> <MetaInfo text="optional" />
 
-  - Deprecated — Instead, [enable the `nodejs_compat_v2` compatibility flag](/workers/runtime-apis/nodejs/#enable-nodejs-with-workers), which enables both built-in Node.js APIs, and adds polyfills as necessary.
+  - Deprecated — Instead, [enable the `nodejs_compat` compatibility flag](/workers/configuration/compatibility-flags/#nodejs-compatibility-flag), which enables both built-in Node.js APIs, and adds polyfills as necessary.
     Setting `node_compat = true` will add polyfills for Node.js built-in modules and globals to your Worker's code, when bundled with Wrangler.
     This is powered by `@esbuild-plugins/node-globals-polyfill` which in itself is powered by [rollup-plugin-node-polyfills](https://github.com/ionic-team/rollup-plugin-node-polyfills/).
 
diff --git a/src/content/partials/workers/nodejs-compat-howto.mdx b/src/content/partials/workers/nodejs-compat-howto.mdx
@@ -3,10 +3,9 @@
 
 ---
 
-:::caution
+:::note
 
-
-To use Node.js APIs in your Worker, add the [`nodejs_compat_v2` compatibility flag](/workers/configuration/compatibility-flags/#nodejs-compatibility-flag) to your `wrangler.toml` file.
+To enable built-in Node.js APIs and polyfills, add the nodejs_compat compatibility flag to your `wrangler.toml`. This also enables nodejs_compat_v2 as long as your compatibility date is 2024-09-23 or later. [Learn more about the Node.js compatibility flag and v2](/workers/configuration/compatibility-flags/#nodejs-compatibility-flag).
 
 
 :::
