docs(devkit): document the createNodes compat for Nx versions

[barbados-clemens]

add new page for the createNodes api compat
add callouts to extending project graph and tooling plugin page

fixes DOC-255

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
nx-dev	Ready	Preview	Oct 21, 2025 10:42pm

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 217a652

Command	Status	Duration	Result
nx affected --targets=lint,test,test-kt,build,e...	✅ Succeeded	3m 37s	View ↗
nx run-many -t check-imports check-commit check...	✅ Succeeded	2m 37s	View ↗
nx-cloud record -- nx-cloud conformance:check	✅ Succeeded	3s	View ↗
nx-cloud record -- nx format:check	✅ Succeeded	<1s	View ↗
nx-cloud record -- nx sync:check	✅ Succeeded	<1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-10-21 23:42:27 UTC

[netlify]

✅ Deploy Preview for nx-docs ready!

Name	Link
🔨 Latest commit	217a652
🔍 Latest deploy log	https://app.netlify.com/projects/nx-docs/deploys/68f8081dca8224000805637c
😎 Deploy Preview	https://deploy-preview-33102--nx-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[nx-cloud]

Nx Cloud is proposing a fix for your failed CI:

We've formatted the newly added createnodes-compatibility.mdoc file to meet Prettier code style requirements. The formatting adjustments include proper indentation, trailing commas, line wrapping for long type declarations, and removal of extra blank lines.

We verified this fix by re-running astro-docs:format.

Suggested Fix changes

diff --git a/astro-docs/src/content/docs/extending-nx/createnodes-compatibility.mdoc b/astro-docs/src/content/docs/extending-nx/createnodes-compatibility.mdoc
index 7be429f6da..26a3aa6441 100644
--- a/astro-docs/src/content/docs/extending-nx/createnodes-compatibility.mdoc
+++ b/astro-docs/src/content/docs/extending-nx/createnodes-compatibility.mdoc
@@ -91,26 +91,28 @@ In Nx 22 the type for v1 of the create nodes api are removed, you can inline the
 import {
   CreateNodesV2,
   CreateNodesContextV2,
-  CreateNodesResult
+  CreateNodesResult,
 } from '@nx/devkit';
 
-
 // inlined types for backwards compat to v1 of createNodes
 // removed in Nx 22
 export interface OldCreateNodesContext extends CreateNodesContextV2 {
-    /**
-     * The subset of configuration files which match the createNodes pattern
-     */
-    readonly configFiles: readonly string[];
+  /**
+   * The subset of configuration files which match the createNodes pattern
+   */
+  readonly configFiles: readonly string[];
 }
 
-
 type OldCreateNodes<T = unknown> = readonly [
   projectFilePattern: string,
   createNodesFunction: CreateNodesFunction<T>
 ];
 
-export type OldCreateNodesFunction<T = unknown> = (projectConfigurationFile: string, options: T | undefined, context: OldCreateNodesContext) => CreateNodesResult | Promise<CreateNodesResult>;
+export type OldCreateNodesFunction<T = unknown> = (
+  projectConfigurationFile: string,
+  options: T | undefined,
+  context: OldCreateNodesContext
+) => CreateNodesResult | Promise<CreateNodesResult>;
 
 export interface MyPluginOptions {
   // your options

  

Or Apply changes locally with:

npx nx-cloud apply-locally oxic-Yu5e

Apply fix locally with your editor ↗  View interactive diff ↗

_{🎓 To learn more about Self Healing CI, please visit nx.dev}

[github-actions]

This pull request has already been merged/closed. If you experience issues related to these changes, please open a new issue referencing this pull request.