chore: refactor for punctuation, spelling and clarity

Author: aheckmann

.editorconfig

@@ -10,3 +10,4 @@ end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
+max_line_length = 80

.github/instructions/docs.instructions.md

@@ -5,3 +5,7 @@ applyTo: "docs/**/*.mdx, !docs/api/**/*.mdx"
 Focus on documentation clarity and accuracy, ensuring that instructions are easy
 to follow and understand by a technical audience. Avoid suggesting changes that
 involve deleting existing content unless it is outdated or incorrect.
+
+When making changes to the documentation, be sure to honor the settings in .editorconfig.
+When editing markdown or .MDX files, ignore the line length limit in bullet points, tables,
+code blocks and front-matter.

docs/ai-solutions/overview.mdx

@@ -5,46 +5,45 @@ description: Use the Plane MCP server to integrate with Plane
 sidebar_position: 1
 ---
 
-{frontMatter.description && <h3 className="description">{frontMatter.description}</h3>}
+{frontMatter.description && (
+  <h3 className="description">{frontMatter.description}</h3>
+)}
 
 ## Introduction
 
-The [Model Context Protocol](https://modelcontextprotocol.io/overview) (MCP) is
-a standardized interface that enables AI models to communicate with external
-tools and services. When combined with Server-Sent Events (SSE), it provides a
-powerful mechanism for real-time data transfer between AI models and external
-systems.
+The [Model Context Protocol](https://modelcontextprotocol.io/overview) (MCP) is a
+standardized interface that enables AI models to communicate with external tools and
+services. When combined with Server-Sent Events (SSE), it provides a powerful
+mechanism for real-time data transfer between AI models and external systems.
 
 :::tip Alpha
 The Plane MCP Server is currently in **Alpha**. Some aspects of the API may change.
-While MCP is standardized, it is also rapidly evolving. The Plane MCP Server
-aims to provide a stable implementation that can be used by developers to build
-robust applications that leverage the power of AI.
-Please send feedback to [email protected].
+While MCP is standardized, it is also rapidly evolving. The Plane MCP Server aims to
+provide a stable implementation for developers to build robust AI-powered
+applications. Please send feedback to [email protected].
 :::
 
 ## Using the Plane MCP Server
 
-Follow the steps below to integrate with the Plane MCP Server.
+Follow these steps to integrate with the Plane MCP Server.
 
 ### Claude.ai
 
 - Open **Settings** from the sidebar on the web or desktop app.
-- Scroll down to the **Integrations** section and click **Add more**.
-- Enter the following Integration URL: `https://mcp.plane.so/sse`
+- Scroll to the **Integrations** section and click **Add more**.
+- Enter the Integration URL: `https://mcp.plane.so/sse`
 - Click **Connect** to link your Plane workspace.
 
 ### Claude Desktop
 
-You can add Plane to [Claude
-Desktop](https://modelcontextprotocol.io/quickstart/user) by updating your
-`claude_desktop_config.json`:
+Add Plane to [Claude Desktop](https://modelcontextprotocol.io/quickstart/user) by
+updating your `claude_desktop_config.json`:
 
 ```json
 {
   "mcpServers": {
     "plane": {
-       "command": "npx",
+      "command": "npx",
       "args": ["mcp-remote", "https://mcp.plane.so/sse"]
     }
   }
@@ -53,48 +52,37 @@ Desktop](https://modelcontextprotocol.io/quickstart/user) by updating your
 
 ### VSCode
 
-You can also connect Plane to
-[VSCode](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server)
+Connect Plane to [VSCode](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server)
 by editing your `.vscode.json` or `mcp.json` file:
 
 ```json
 {
   "servers": {
     "plane": {
-       "command": "npx",
+      "command": "npx",
       "args": ["mcp-remote", "https://mcp.plane.so/sse"]
     }
   }
 }
 ```
 
-If you face any issues with Plane Auth, please run the command below in the
-terminal to remove stale auth tokens. Then, restart the server. MCP Remote
-servers are still experimental.
+If you encounter issues with Plane Auth, run the following command in your terminal to
+remove stale auth tokens, then restart the server. MCP Remote servers are still
+experimental.
 
 ```bash
 rm -rf ~/.mcp-auth/mcp-remote-*
 ```
 
 ## Activating the Plane MCP Server
 
-After following the above steps, when activating the server, you will be
-prompted via your browser to connect your Plane workspace to the MCP server.
+After setup, when activating the server, you will be prompted in your browser to
+connect your Plane workspace to the MCP server.
 
-When prompted to authorize, click "**Approve**".
+When prompted to authorize, click **Approve**.
 
-import Approve from '@site/static/images/mcp/approve.png';
-
-<img style={{width: '600px'}} className="center" src={Approve} alt="authorization" />
-
-<br/>
-<br/>
-Next, choose the workspace to which you want to connect, review the permissions
-and click "**Accept**".
-
-import Accept from '@site/static/images/mcp/accept.png';
-
-<img style={{width: '600px'}} className="center" src={Accept} alt="accept" />
+Next, choose the workspace you want to connect, review the permissions, and click
+**Accept**.
 
 ## Congrats!