Restructure first section of docs and adjust content

Author: danilo-leal

docs/docs.json

@@ -50,12 +50,13 @@
         "tab": "Protocol",
         "pages": [
           {
-            "group": "Overview",
+            "group": "Get Started",
             "pages": [
-              "overview/introduction",
-              "overview/architecture",
-              "overview/agents",
-              "overview/clients"
+              "get-started/introduction",
+              "get-started/architecture",
+              "get-started/agents",
+              "get-started/clients",
+              "get-started/registry"
             ]
           },
           {
@@ -95,10 +96,6 @@
               "libraries/typescript",
               "libraries/community"
             ]
-          },
-          {
-            "group": "Registry",
-            "pages": ["registry/index"]
           }
         ]
       },
@@ -165,5 +162,32 @@
   },
   "contextual": {
     "options": ["copy", "view"]
-  }
+  },
+  "redirects": [
+    {
+      "source": "/overview/introduction",
+      "destination": "/get-started/introduction",
+      "permanent": true
+    },
+    {
+      "source": "/overview/architecture",
+      "destination": "/get-started/architecture",
+      "permanent": true
+    },
+    {
+      "source": "/overview/agents",
+      "destination": "/get-started/agents",
+      "permanent": true
+    },
+    {
+      "source": "/overview/clients",
+      "destination": "/get-started/clients",
+      "permanent": true
+    },
+    {
+      "source": "/registry",
+      "destination": "/get-started/registry",
+      "permanent": true
+    }
+  ]
 }

docs/registry/_agents.mdx docs/get-started/_registry_agents.mdxdocs/registry/_agents.mdx renamed to docs/get-started/_registry_agents.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Agents"
-description: "Agents implementing the Agent Client Protocol"
+description: "Agents implementing the Agent Client Protocol."
 ---
 
 The following agents can be used with an ACP Client:

docs/overview/agents.mdx docs/get-started/agents.mdxdocs/overview/agents.mdx renamed to docs/get-started/agents.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Architecture"
-description: "Overview of the Agent Client Protocol architecture"
+description: "Overview of the Agent Client Protocol architecture."
 ---
 
 The Agent Client Protocol defines a standard interface for communication between AI agents and client applications. The architecture is designed to be flexible, extensible, and platform-agnostic.

docs/overview/architecture.mdx docs/get-started/architecture.mdxdocs/overview/architecture.mdx renamed to docs/get-started/architecture.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Clients"
-description: "Clients implementing the Agent Client Protocol"
+description: "Clients implementing the Agent Client Protocol."
 ---
 
 The following clients can be used with an ACP Agent:

docs/overview/clients.mdx docs/get-started/clients.mdxdocs/overview/clients.mdx renamed to docs/get-started/clients.mdx

@@ -1,9 +1,9 @@
 ---
 title: "Introduction"
-description: "Get started with the Agent Client Protocol (ACP)"
+description: "Get started with the Agent Client Protocol."
 ---
 
-The Agent Client Protocol standardizes communication between code editors/IDEs and coding agents and is suitable for both local and remote scenarios.
+The Agent Client Protocol (ACP) standardizes communication between code editors/IDEs and coding agents and is suitable for both local and remote scenarios.
 
 ## Why ACP?
 
@@ -28,7 +28,10 @@ ACP is suitable for both local and remote scenarios:
 - **Local agents** run as sub-processes of the code editor, communicating via JSON-RPC over stdio.
 - **Remote agents** can be hosted in the cloud or on separate infrastructure, communicating over HTTP or WebSocket
 
-> **Note:** Full support for remote agents is a work in progress. We are actively collaborating with agentic platforms to ensure the protocol addresses the specific requirements of cloud-hosted and remote deployment scenarios.
+<Info>
+    Full support for remote agents is a work in progress. 
+    We are actively collaborating with agentic platforms to ensure the protocol addresses the specific requirements of cloud-hosted and remote deployment scenarios.
+</Info>
 
 The protocol re-uses the JSON representations used in MCP where possible, but includes custom types for useful agentic coding UX elements, like displaying diffs.
 

docs/overview/introduction.mdx docs/get-started/introduction.mdxdocs/overview/introduction.mdx renamed to docs/get-started/introduction.mdx

@@ -1,6 +1,6 @@
 ---
-title: Official ACP Registry
-description: Discover Agent Client Protocol agents
+title: ACP Registry
+description: The easiest way to find and install ACP-compatible agents.
 ---
 
 <style>{`
@@ -11,13 +11,24 @@ description: Discover Agent Client Protocol agents
 }
 `}</style>
 
-The ACP Agent Registry is a curated collection of agents implementing the Agent Client Protocol.
+## Overview
+
+The ACP Registry is an easy way for developers to distribute their ACP-compatible agents to any client that speaks the protocol.
+
+At the moment, this is a curated set of agents, including only the ones that [support authentication](/rfds/auth-methods).
+
+Visit [the registry repository on GitHub](https://github.com/agentclientprotocol/registry) to learn more about it.
+
+<Warning>
+  The registry is under active development, so expect its format and contents to change.
+</Warning>
 
 ## Available Agents
 
-<CardGroup cols={2}>
+<CardGroup cols={3}>
   <Card
     title="Auggie CLI"
+    href="https://github.com/augmentcode/auggie-zed-extension"
     icon={
       <svg
         width="20"
@@ -39,16 +50,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/augmentcode/auggie-zed-extension"
   >
-    Augment Code&#39;s powerful software agent, backed by industry-leading
-    context engine
-    <p>
+    <p className="mt-2 text-xs">
       <code>0.14.0</code>
     </p>
   </Card>
   <Card
     title="Claude Code"
+    href="https://github.com/zed-industries/claude-code-acp"
     icon={
       <svg
         width="20"
@@ -65,15 +74,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/zed-industries/claude-code-acp"
   >
-    ACP wrapper for Anthropic&#39;s Claude
-    <p>
+    <p className="mt-2 text-xs">
       <code>0.13.2</code>
     </p>
   </Card>
   <Card
     title="Codex CLI"
+    href="https://github.com/zed-industries/codex-acp"
     icon={
       <svg
         width="20"
@@ -90,10 +98,8 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/zed-industries/codex-acp"
   >
-    ACP adapter for OpenAI&#39;s coding assistant
-    <p>
+    <p className="mt-2 text-xs">
       <code>0.9.0</code>
     </p>
   </Card>
@@ -117,13 +123,13 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
       </svg>
     }
   >
-    Factory Droid - AI coding agent powered by Factory AI
-    <p>
-      <code>0.56.3</code>
+    <p className="mt-2 text-xs">
+      <code>0.52.0</code>
     </p>
   </Card>
   <Card
     title="Gemini CLI"
+    href="https://github.com/google-gemini/gemini-cli"
     icon={
       <svg
         width="20"
@@ -140,15 +146,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/google-gemini/gemini-cli"
   >
-    Google&#39;s official CLI for Gemini
-    <p>
-      <code>0.26.0</code>
+    <p className="mt-2 text-xs">
+      <code>0.25.2</code>
     </p>
   </Card>
   <Card
     title="GitHub Copilot"
+    href="https://github.com/github/copilot-language-server-release"
     icon={
       <svg
         width="20"
@@ -176,15 +181,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/github/copilot-language-server-release"
   >
-    GitHub&#39;s AI pair programmer
-    <p>
+    <p className="mt-2 text-xs">
       <code>1.417.0</code>
     </p>
   </Card>
   <Card
     title="Mistral Vibe"
+    href="https://github.com/mistralai/mistral-vibe"
     icon={
       <svg
         width="20"
@@ -238,15 +242,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/mistralai/mistral-vibe"
   >
-    Mistral&#39;s open-source coding assistant
-    <p>
-      <code>2.0.0</code>
+    <p className="mt-2 text-xs">
+      <code>1.3.5</code>
     </p>
   </Card>
   <Card
     title="OpenCode"
+    href="https://github.com/sst/opencode"
     icon={
       <svg
         width="20"
@@ -266,15 +269,14 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/sst/opencode"
   >
-    The open source coding agent
-    <p>
-      <code>1.1.39</code>
+    <p className="mt-2 text-xs">
+      <code>1.1.36</code>
     </p>
   </Card>
   <Card
     title="Qwen Code"
+    href="https://github.com/QwenLM/qwen-code"
     icon={
       <svg
         width="20"
@@ -291,33 +293,13 @@ The ACP Agent Registry is a curated collection of agents implementing the Agent
         />
       </svg>
     }
-    href="https://github.com/QwenLM/qwen-code"
   >
-    Alibaba&#39;s Qwen coding assistant
-    <p>
-      <code>0.8.1</code>
+    <p className="mt-2 text-xs">
+      <code>0.7.2</code>
     </p>
   </Card>
 </CardGroup>
 
-<Warning>
-  **Work in Progress**: This registry is under active development. Format and
-  contents may change.
-</Warning>
-
-<Note>
-  This registry only includes agents that support
-  [authentication](/rfds/auth-methods). Agents must implement auth flows to be
-  listed here. Not all ACP-compatible agents are listed yet—as soon as they're
-  ready, we'll be happy to add them.
-</Note>
-
-<Info>
-  The registry is hosted at
-  [github.com/agentclientprotocol/registry](https://github.com/agentclientprotocol/registry).
-  Visit the repository to contribute your own agent.
-</Info>
-
 ## Using the Registry
 
 Clients can fetch the registry programmatically:
@@ -328,13 +310,13 @@ curl https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json
 
 The registry JSON contains all agent metadata including distribution information for automatic installation.
 
-## Contributing
+## Submit your Agent
 
 To add your agent to the registry:
 
-1. Fork the [registry repository](https://github.com/agentclientprotocol/registry)
+1. Fork the [registry repository on GitHub](https://github.com/agentclientprotocol/registry)
 2. Create a folder with your agent's ID (lowercase, hyphens allowed)
-3. Add an `agent.json` file following the [schema](https://github.com/agentclientprotocol/registry/blob/main/agent.schema.json)
+3. Add an `agent.json` file following [the schema](https://github.com/agentclientprotocol/registry/blob/main/agent.schema.json)
 4. Optionally add an `icon.svg` (16x16 recommended)
 5. Submit a pull request