adjust title; copy tweaks

EdwardAngert · EdwardAngert · commit b45bf9712a0b · 2025-04-04T20:30:36.000Z
diff --git a/docs/coder-ai/README.md b/docs/coder-ai/README.md
@@ -15,7 +15,7 @@ AI Coding Agents such as [Claude Code](https://docs.anthropic.com/en/docs/agents
 - Protyping web applications or landing pages
 - Researching / onboarding to a codebase
 - Assisting with lightweight refactors
-- Writing tests and documentation
+- Writing tests and draft documentation
 - Small, well-defined chores
 
 With Coder, you can self-host AI agents in isolated development environments with proper context and tooling around your existing developer workflows. Whether you are a regulated enterprise or an individual developer, running AI agents at scale with Coder is much more productive and secure than running them locally.
diff --git a/docs/coder-ai/best-practices.md b/docs/coder-ai/best-practices.md
@@ -1,4 +1,4 @@
-# Best Practices & Adding Tools via MCP
+# Model Context Protocols (MCP) and adding AI tools
 
 > [!NOTE]
 >
@@ -22,18 +22,20 @@ for development. With AI Agents, this is no exception.
 
 ## Best Practices
 
-- Since agents are still early, it is best to use the most capable ML models you
-  have access to in order to evaluate their performance.
+- Use the most capable ML models you have access to in order to evaluate Agent
+  performance.
 - Set a system prompt with the `AI_SYSTEM_PROMPT` environment in your template
 - Within your repositories, write a `.cursorrules`, `CLAUDE.md` or similar file
   to guide the agent's behavior.
 - To read issue descriptions or pull request comments, install the proper CLI
   (e.g. `gh`) in your image/template.
 - Ensure your [template](./create-template.md) is truly pre-configured for
   development without manual intervention (e.g. repos are cloned, dependencies
-  are built, secrets are added/mocked, etc.)
+  are built, secrets are added/mocked, etc.).
+
   > Note: [External authentication](../admin/external-auth.md) can be helpful
   > to authenticate with third-party services such as GitHub or JFrog.
+
 - Give your agent the proper tools via MCP to interact with your codebase and
   related services.
 - Read our recommendations on [securing agents](./securing.md) to avoid
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -698,8 +698,8 @@
 					"state": ["early access"]
 				},
 				{
-					"title": "Best practices \u0026 adding tools via MCP",
-					"description": "Improve results by adding tools to your agents",
+					"title": "Model Context Protocols (MCP) and adding AI tools",
+					"description": "Improve results by adding tools to your AI agents",
 					"path": "./coder-ai/best-practices.md",
 					"state": ["early access"]
 				},
