minor updates to sequencing of docs (#592)

Author: andrew-lastmile

docs/docs.json

@@ -33,8 +33,8 @@
             "group": "Get Started",
             "pages": [
               "get-started/welcome",
-              "get-started/install",
               "get-started/quickstart",
+              "get-started/install",
               "get-started/deploy-to-cloud"
             ]
           },

docs/get-started/install.mdx

@@ -1,6 +1,6 @@
 ---
 title: Installation
-sidebarTitle: "Install"
+sidebarTitle: "Installation"
 description: "Set up mcp-agent, the CLI, and optional provider extras."
 icon: arrow-down-to-line
 ---

docs/get-started/quickstart.mdx

@@ -11,16 +11,24 @@ Let's get you set up with a hello world mcp-agent!
 
 <Tabs>
   <Tab title="Use CLI (Recommended)">
-    ```bash
-    mkdir mcp-basic-agent
-    cd mcp-basic-agent
-    uvx mcp-agent init
-    uv init
-    uv add mcp-agent
-    uv sync
-    ```
-
-    (Prefer pip? `pip install mcp-agent` works too.)
+    <Steps>
+      <Step title="Create a folder">
+        ```bash
+        mkdir mcp-basic-agent
+        cd mcp-basic-agent
+        ```
+      </Step>
+
+      <Step title="Initialize your mcp-agent">
+        ```bash
+        uvx mcp-agent init
+        uv init
+        uv add mcp-agent
+        uv sync
+        ```
+        (Prefer pip? `python -m venv .venv && pip install mcp-agent` works too.)
+      </Step>
+    </Steps>
   </Tab>
   <Tab title="Do it manually">
     <Steps>

docs/get-started/welcome.mdx

@@ -18,7 +18,7 @@ icon: hand-wave
 
 <CardGroup cols={2}>
   <Card title="Composable patterns" icon="puzzle-piece">
-    Parallel, router, planner, evaluator—every pattern from Anthropic's guide (plus OpenAI Swarm-style handoffs) ships as a first-class workflow.
+    Parallel, router, planner, evaluator—every pattern from Anthropic's guide ships as a first-class workflow.
   </Card>
   <Card title="MCP-native" icon="plug">
     Works with any MCP server. Drop in the filesystem, fetch, Slack, Jira, or your own FastMCP servers and start calling tools immediately.
@@ -56,7 +56,7 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-## Start building
+## Next steps
 
 <CardGroup cols={2}>
   <Card
@@ -88,36 +88,3 @@ if __name__ == "__main__":
     Learn how to combine planner, router, evaluator, and more.
   </Card>
 </CardGroup>
-
-Want to go deeper? Browse [Core Components](/mcp-agent-sdk/overview) for API details or jump to [MCP Servers](/mcp-agent-sdk/mcp/overview) to see how FastMCP integrates with agents.
-
-<CardGroup cols={2}>
-  <Card
-    title="Installation"
-    icon="arrow-down-to-line"
-    href="/get-started/install"
-  >
-    Set up your development environment
-  </Card>
-  <Card
-    title="Quickstart"
-    icon="rocket-launch"
-    href="/get-started/quickstart"
-  >
-    Build your first agent in 5 minutes
-  </Card>
-  <Card
-    title="Core Concepts"
-    icon="graduation-cap"
-    href="/mcp-agent-sdk/overview"
-  >
-    Understand agents, workflows, and MCP
-  </Card>
-  <Card
-    title="Examples"
-    icon="code"
-    href="https://github.com/lastmile-ai/mcp-agent/tree/main/examples"
-  >
-    Explore 30+ working examples
-  </Card>
-</CardGroup>