docs: update ai feature stage to beta and ease the intro note's tone (#17620)

EdwardAngert · web-flow · commit ef101ae2a037 · 2025-04-30T15:20:44.000Z
[preview](https://coder.com/docs/@ai-feature-stage/ai-coder)
diff --git a/docs/ai-coder/best-practices.md b/docs/ai-coder/best-practices.md
@@ -2,10 +2,10 @@
 
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/coder-dashboard.md b/docs/ai-coder/coder-dashboard.md
@@ -1,9 +1,9 @@
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/create-template.md b/docs/ai-coder/create-template.md
@@ -2,10 +2,10 @@
 
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/custom-agents.md b/docs/ai-coder/custom-agents.md
@@ -2,10 +2,10 @@
 
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/headless.md b/docs/ai-coder/headless.md
@@ -1,9 +1,9 @@
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/ide-integration.md b/docs/ai-coder/ide-integration.md
@@ -1,9 +1,9 @@
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/index.md b/docs/ai-coder/index.md
@@ -2,10 +2,10 @@
 
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/issue-tracker.md b/docs/ai-coder/issue-tracker.md
@@ -2,10 +2,10 @@
 
 > [!NOTE]
 >
-> This functionality is in early access and is evolving rapidly.
+> This functionality is in beta and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/ai-coder/securing.md b/docs/ai-coder/securing.md
@@ -2,8 +2,8 @@
 >
 > This functionality is in early access and is evolving rapidly.
 >
-> For now, we recommend testing it in a demo or staging environment,
-> rather than deploying to production.
+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
+> Always review AI-generated content before using it in critical systems.
 >
 > Join our [Discord channel](https://discord.gg/coder) or
 > [contact us](https://coder.com/contact) to get help or share feedback.
diff --git a/docs/images/guides/ai-agents/landing.png b/docs/images/guides/ai-agents/landing.png
diff --git a/docs/images/icons/wand.svg b/docs/images/icons/wand.svg
@@ -1,3 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40" fill="none" stroke="#fff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.25" class="lucide lucide-wand-icon lucide-wand" viewBox="0 0 24 24">
-  <path d="M15 4V2M15 16v-2M8 9h2M20 9h2M17.8 11.8 19 13M15 9h.01M17.8 6.2 19 5M3 21l9-9M12.2 6.2 11 5"/>
-</svg>
+<svg version="1.2" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 180 180" width="180" height="180"><style>.a{fill:none;stroke:#000;stroke-linecap:round;stroke-linejoin:round;stroke-width:15}</style><path fill-rule="evenodd" class="a" d="m112.5 30v-15"/><path fill-rule="evenodd" class="a" d="m112.5 120v-15"/><path fill-rule="evenodd" class="a" d="m60 67.5h15"/><path fill-rule="evenodd" class="a" d="m150 67.5h15"/><path fill-rule="evenodd" class="a" d="m133.5 88.5l9 9"/><path fill-rule="evenodd" class="a" d="m112.5 67.5h0.1"/><path fill-rule="evenodd" class="a" d="m133.5 46.5l9-9"/><path fill-rule="evenodd" class="a" d="m22.5 157.5l67.5-67.5"/><path fill-rule="evenodd" class="a" d="m91.5 46.5l-9-9"/></svg>
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -684,7 +684,7 @@
 			"description": "Learn how to run and integrate AI coding agents like GPT-Code, OpenDevin, or SWE-Agent in Coder workspaces to boost developer productivity.",
 			"path": "./ai-coder/index.md",
 			"icon_path": "./images/icons/wand.svg",
-			"state": ["early access"],
+			"state": ["beta"],
 			"children": [
 				{
 					"title": "Learn about coding agents",
@@ -695,37 +695,37 @@
 					"title": "Create a Coder template for agents",
 					"description": "Create a purpose-built template for your AI agents",
 					"path": "./ai-coder/create-template.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Integrate with your issue tracker",
 					"description": "Assign tickets to AI agents and interact via code reviews",
 					"path": "./ai-coder/issue-tracker.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Model Context Protocols (MCP) and adding AI tools",
 					"description": "Improve results by adding tools to your AI agents",
 					"path": "./ai-coder/best-practices.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Supervise agents via Coder UI",
 					"description": "Interact with agents via the Coder UI",
 					"path": "./ai-coder/coder-dashboard.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Supervise agents via the IDE",
 					"description": "Interact with agents via VS Code or Cursor",
 					"path": "./ai-coder/ide-integration.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Programmatically manage agents",
 					"description": "Manage agents via MCP, the Coder CLI, and/or REST API",
 					"path": "./ai-coder/headless.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				},
 				{
 					"title": "Securing agents in Coder",
@@ -737,7 +737,7 @@
 					"title": "Custom agents",
 					"description": "Learn how to use custom agents with Coder",
 					"path": "./ai-coder/custom-agents.md",
-					"state": ["early access"]
+					"state": ["beta"]
 				}
 			]
 		},

Original file line number	Diff line number	Diff line change
`@@ -2,10 +2,10 @@`
`2`	`2`
`3`	`3`	`> [!NOTE]`
`4`	`4`	`>`
`5`		`-> This functionality is in early access and is evolving rapidly.`
	`5`	`+> This functionality is in beta and is evolving rapidly.`
`6`	`6`	`>`
`7`		`-> For now, we recommend testing it in a demo or staging environment,`
`8`		`-> rather than deploying to production.`
	`7`	`+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.`
	`8`	`+> Always review AI-generated content before using it in critical systems.`
`9`	`9`	`>`
`10`	`10`	`> Join our [Discord channel](https://discord.gg/coder) or`
`11`	`11`	`> [contact us](https://coder.com/contact) to get help or share feedback.`
Original file line number	Diff line number	Diff line change
`@@ -1,9 +1,9 @@`
`1`	`1`	`> [!NOTE]`
`2`	`2`	`>`
`3`		`-> This functionality is in early access and is evolving rapidly.`
	`3`	`+> This functionality is in beta and is evolving rapidly.`
`4`	`4`	`>`
`5`		`-> For now, we recommend testing it in a demo or staging environment,`
`6`		`-> rather than deploying to production.`
	`5`	`+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.`
	`6`	`+> Always review AI-generated content before using it in critical systems.`
`7`	`7`	`>`
`8`	`8`	`> Join our [Discord channel](https://discord.gg/coder) or`
`9`	`9`	`> [contact us](https://coder.com/contact) to get help or share feedback.`
Original file line number	Diff line number	Diff line change
`@@ -2,8 +2,8 @@`
`2`	`2`	`>`
`3`	`3`	`> This functionality is in early access and is evolving rapidly.`
`4`	`4`	`>`
`5`		`-> For now, we recommend testing it in a demo or staging environment,`
`6`		`-> rather than deploying to production.`
	`5`	`+> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.`
	`6`	`+> Always review AI-generated content before using it in critical systems.`
`7`	`7`	`>`
`8`	`8`	`> Join our [Discord channel](https://discord.gg/coder) or`
`9`	`9`	`> [contact us](https://coder.com/contact) to get help or share feedback.`