Chore: Add note around data planes (#215)

robertjdominguez · web-flow · commit e58d244b2e46 · 2025-09-15T13:20:57.000-07:00
## Description 📝

As titled.
diff --git a/docs/_quickstart_template.mdx b/docs/_quickstart_template.mdx
@@ -20,7 +20,8 @@ acknowledge your login, giving you access to Hasura Cloud resources.
 ### Step 2. Scaffold out a new local project
 
 ```ddn title="Next, create a new local project:"
-ddn supergraph init imdb-promptflix --with-promptql && cd imdb-promptflix
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init imdb-promptflix --with-promptql --project-data-plane-id <your-data-plane-id> && cd imdb-promptflix
 ```
 
 Now that you're in this directory, you'll see your project scaffolded out for you. You can view the structure by either
diff --git a/docs/how-to-build-with-promptql/_boilerplateInit.mdx b/docs/how-to-build-with-promptql/_boilerplateInit.mdx
@@ -18,7 +18,8 @@ in, the CLI will acknowledge your login, giving you access to Hasura DDN resourc
 ### Step 2. Scaffold out a new local project
 
 ```ddn title="Next, create a new local project:"
-ddn supergraph init my-project --with-promptql && cd my-project
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init my-project --with-promptql --project-data-plane-id <your-data-plane-id> && cd my-project
 ```
 
 Once you move into this directory, you'll see your project scaffolded out for you. You can view the structure by either
diff --git a/docs/metadata/guides/iterate.mdx b/docs/metadata/guides/iterate.mdx
@@ -102,7 +102,8 @@ You can also create a new build on Hasura Cloud:
 If you don't have a project on Hasura Cloud, you can create one by running:
 
 ```ddn
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 Then:
diff --git a/docs/project-configuration/subgraphs/working-with-multiple-repositories.mdx b/docs/project-configuration/subgraphs/working-with-multiple-repositories.mdx
@@ -91,7 +91,8 @@ overall API.
 This will serve as the parent project.
 
 ```ddn
-ddn supergraph init <parent-project> && cd <parent-project> && git init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init <parent-project> --project-data-plane-id <your-data-plane-id> && cd <parent-project> && git init
 ```
 
 This will scaffold the local configuration for your PromptQL project and initialize a Git repository.
@@ -101,7 +102,8 @@ This will scaffold the local configuration for your PromptQL project and initial
 This is based on the local parent project.
 
 ```ddn
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 In your configuration file (e.g., `.hasura/context.yaml`), you'll see a new `project` entry with the name of the project
@@ -164,7 +166,8 @@ The invited user will need to create a new supergraph on their machine with a ne
 They will use the same name for the subgraph as was created in the parent project.
 
 ```ddn
-ddn supergraph init <subgraph-name-as-supergraph-name> --create-subgraph <subgraph-name> && cd <subgraph-name> && git init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init <subgraph-name-as-supergraph-name> --create-subgraph <subgraph-name> --project-data-plane-id <your-data-plane-id> && cd <subgraph-name> && git init
 ```
 
 This scaffolds the necessary structure and initializes a Git repository.
@@ -174,7 +177,8 @@ This scaffolds the necessary structure and initializes a Git repository.
 This will initialize the cloud project as the parent project.
 
 ```ddn
-ddn project init --with-project <parent-project-name>
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --with-project <parent-project-name> --data-plane-id <your-data-plane-id>
 ```
 
 Your configuration file will now link the local subgraph to the parent project.
diff --git a/docs/project-configuration/tutorials/work-with-multiple-repositories.mdx b/docs/project-configuration/tutorials/work-with-multiple-repositories.mdx
@@ -58,7 +58,8 @@ provisioning subgraphs, inviting collaborators, and managing the API as a whole.
 ### Step 1. Initialize a new local project
 
 ```ddn title="Create a new local project and initialize a git repository:"
-ddn supergraph init parent-project --with-promptql && cd parent-project && git init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init parent-project --with-promptql --project-data-plane-id <your-data-plane-id> && cd parent-project && git init
 ```
 
 This will scaffold out the local configuration for a PromptQL project and initialize a git repository.
@@ -113,7 +114,8 @@ initializing a new repository below.
 #### Step 1. Create a new repo for the `customers` subgraph
 
 ```ddn title="Initialize a new local project and git repo while also mapping to the existing cloud project:"
-ddn supergraph init customer-team --create-subgraph customers --with-project <project-name> --with-promptql && cd customer-team && git init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init customer-team --create-subgraph customers --with-project <project-name> --with-promptql --project-data-plane-id <your-data-plane-id> && cd customer-team && git init
 ```
 
 This will scaffold out the necessary project structure along with initializing a git repository for version control.
@@ -252,7 +254,8 @@ The steps below will allow you to incorporate your independent `billing` subgrap
 #### Step 1. Create a new repo for the `billing` subgraph
 
 ```ddn title="Initialize a new local project and git repo:"
-ddn supergraph init billing-team --with-project <project-name> --create-subgraph billing --with-promptql && cd billing-team && git init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init billing-team --with-project <project-name> --create-subgraph billing --with-promptql --project-data-plane-id <your-data-plane-id> && cd billing-team && git init
 ```
 
 This will scaffold out the necessary project structure along with initializing a git repository for version control.
diff --git a/docs/promptql-playground/troubleshooting.mdx b/docs/promptql-playground/troubleshooting.mdx
@@ -30,7 +30,8 @@ ddn context get project
 If you get the error `Key "project" is not set.`, you need to initialize a DDN project.
 
 ```ddn title="Run the following command in the project directory:"
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 Restarting the local services post this should fix the issue.
diff --git a/docs/recipes/tutorials/apple-health-assistant.mdx b/docs/recipes/tutorials/apple-health-assistant.mdx
@@ -87,7 +87,8 @@ Now, let's set up the Hasura DDN project with PromptQL to start exploring the da
 ```bash copy
 cd ddn-project
 ddn supergraph build local
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 - Add Anthropic API key to the`.env`.
diff --git a/docs/recipes/tutorials/bart-api.mdx b/docs/recipes/tutorials/bart-api.mdx
@@ -69,7 +69,8 @@ Now, let's set up the Hasura DDN project with PromptQL to start exploring the da
 In the root directory of the repo, run the following commands:
 
 ```ddn
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 Create a build:
diff --git a/docs/recipes/tutorials/csv-files.mdx b/docs/recipes/tutorials/csv-files.mdx
@@ -65,7 +65,8 @@ In the root directory of the repo, run the following commands:
 
 ```ddn
 ddn supergraph build local
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 - Start the DDN project
diff --git a/docs/recipes/tutorials/duckduckgo-web-search.mdx b/docs/recipes/tutorials/duckduckgo-web-search.mdx
@@ -64,7 +64,8 @@ In the root directory of the repo, run the following commands:
 
 ```ddn
 ddn supergraph build local
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 - Start the DDN project
diff --git a/docs/recipes/tutorials/github-assistant.mdx b/docs/recipes/tutorials/github-assistant.mdx
@@ -81,7 +81,8 @@ Head to `app/connector/github/index.ts` and change the org name and the repo nam
 This will create a Hasura DDN cloud project and set up PromptQL keys to connect to the PromptQL runtime.
 
 ```ddn
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 ### Fire up your PromptQL project
diff --git a/docs/recipes/tutorials/huggingface-csv-parquet-sqlite.mdx b/docs/recipes/tutorials/huggingface-csv-parquet-sqlite.mdx
@@ -117,7 +117,8 @@ In the root directory of the repo, run the following commands:
 
 ```ddn
 ddn supergraph build local
-ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --data-plane-id <your-data-plane-id>
 ```
 
 - Start the DDN project
diff --git a/docs/recipes/tutorials/kaggle-csv-sqlite.mdx b/docs/recipes/tutorials/kaggle-csv-sqlite.mdx
@@ -101,7 +101,8 @@ In the root directory of the repo, run the following commands:
 
 ```ddn
 ddn supergraph build local
-ddn project init --with-promptql
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init --with-promptql --data-plane-id <your-data-plane-id>
 ```
 
 - Start the DDN project
diff --git a/docs/reference/cli/commands/ddn_project_init.mdx b/docs/reference/cli/commands/ddn_project_init.mdx
@@ -1,7 +1,9 @@
 ---
 sidebar_label: ddn project init
 sidebar_position: 77
-description: Configure the local directory to use a Hasura DDN project, creating a DDN project and subgraphs as necessary using the DDN CLI
+description:
+  Configure the local directory to use a Hasura DDN project, creating a DDN project and subgraphs as necessary using the
+  DDN CLI
 canonicalUrl: "https://promptql.io/docs/reference/cli/commands/ddn_project_init"
 keywords:
   - hasura
@@ -20,17 +22,20 @@ Configure the local directory to use a Hasura DDN project, creating a DDN projec
 Configure the local directory to use a Hasura DDN project, creating a DDN project and subgraphs as necessary
 
 ```bash
-ddn project init [project-name] [flags]
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn project init [project-name] [flags] --data-plane-id <your-data-plane-id>
 ```
 
 ## Examples
 
 ```bash
 # Initialize a new Hasura DDN project (with an auto-generated name) with subgraphs based on your local directory
- ddn project init
+# If you don't have a data plane provisioned, please contact your AI strategist
+ ddn project init --data-plane-id <your-data-plane-id>
 
 # Configure the local directory to use an existing Hasura DDN project creating subgraphs on the DDN project as necessary
- ddn project init --with-project myproject
+# If you don't have a data plane provisioned, please contact your AI strategist
+ ddn project init --with-project myproject --data-plane-id <your-data-plane-id>
 ```
 
 ## Options
diff --git a/docs/reference/cli/commands/ddn_supergraph_init.mdx b/docs/reference/cli/commands/ddn_supergraph_init.mdx
@@ -17,20 +17,24 @@ Initialize a new Supergraph project directory.
 
 ## Synopsis
 
-This command is most often the first run with a new project. Use this to create a new supergraph directory and then begin to create your API. To learn more, check out the quickstart: https://hasura.io/docs/3.0/quickstart
+This command is most often the first run with a new project. Use this to create a new supergraph directory and then
+begin to create your API. To learn more, check out the quickstart: https://hasura.io/docs/3.0/quickstart
 
 ```bash
-ddn supergraph init <path-to-project-dir> [flags]
+# If you don't have a data plane provisioned, please contact your AI strategist
+ddn supergraph init <path-to-project-dir> [flags] --project-data-plane-id <your-data-plane-id>
 ```
 
 ## Examples
 
 ```bash
 # Initialize a new Supergraph project directory with a default subgraph 'app'
- ddn supergraph init <path-to-project-dir>
+# If you don't have a data plane provisioned, please contact your AI strategist
+ ddn supergraph init <path-to-project-dir> --project-data-plane-id <your-data-plane-id>
 
 # Initialize a new Supergraph project directory with a subgraph 'mysg'
- ddn supergraph init <path-to-project-dir> --create-subgraph mysg
+# If you don't have a data plane provisioned, please contact your AI strategist
+ ddn supergraph init <path-to-project-dir> --create-subgraph mysg --project-data-plane-id <your-data-plane-id>
 ```
 
 ## Options
