From 5e8bf22596182707a1766259fe3d2e4c2fb07bc5 Mon Sep 17 00:00:00 2001
From: Kathryn May <kathryn@langchain.dev>
Date: Wed, 29 Oct 2025 12:02:15 -0400
Subject: [PATCH 1/2] Adjust deployment guide position + configuration group

---
 src/docs.json                  | 25 ++++++++++---------------
 src/langsmith/deployments.mdx  | 26 +++++++++++++++++++-------
 src/langsmith/local-server.mdx |  2 +-
 3 files changed, 30 insertions(+), 23 deletions(-)

diff --git a/src/docs.json b/src/docs.json
index 2e19592a30..64fbf6f5ef 100644
--- a/src/docs.json
+++ b/src/docs.json
@@ -1168,22 +1168,9 @@
               "langsmith/deployments",
               "langsmith/local-server",
               "langsmith/app-development",
+              "langsmith/deployment-quickstart",
               {
-                "group": "Deploy to cloud",
-                "pages": [
-                  "langsmith/deployment-quickstart",
-                  "langsmith/deploy-to-cloud"
-                ]
-              },
-              {
-                "group": "Deploy to self-hosted or hybrid",
-                "pages": [
-                  "langsmith/deploy-with-control-plane",
-                  "langsmith/deploy-standalone-server"
-                ]
-              },
-              {
-                "group": "Configure for deployment",
+                "group": "Configure app for deployment",
                 "pages": [
                   "langsmith/application-structure",
                   {
@@ -1211,6 +1198,14 @@
                     "langsmith/cicd-pipeline-example"
                   ]
               },
+              {
+                "group": "Deployment guides",
+                "pages": [
+                  "langsmith/deploy-to-cloud",
+                  "langsmith/deploy-with-control-plane",
+                  "langsmith/deploy-standalone-server"
+                ]
+              },
               {
                 "group": "App development",
                 "pages": [
diff --git a/src/langsmith/deployments.mdx b/src/langsmith/deployments.mdx
index 956e4c27d9..eee66c9693 100644
--- a/src/langsmith/deployments.mdx
+++ b/src/langsmith/deployments.mdx
@@ -12,13 +12,25 @@ This section covers how to package, build, and deploy your _agents_ and applicat
 
 A typical deployment workflow consists of the following steps:
 
-1. **[Test locally](/langsmith/local-server)**: Run your application on a local server.
-2. **[Choose hosting](/langsmith/hosting)**: (Required for deployment) Select Cloud, Hybrid, or Self-hosted.
-3. **Deploy your app**:
-   - [**Cloud**](/langsmith/deploy-to-cloud): Push code from a git repository
-   - [**Hybrid or Self-hosted with control plane**](/langsmith/deploy-with-control-plane): Build and push Docker images, deploy via UI
-   - [**Standalone servers**](/langsmith/deploy-standalone-server): Deploy directly without control plane
-4. **[Monitor & manage](/langsmith/observability)**: Track traces, alerts, and dashboards.
+<Steps>
+  <Step title={<a href="/langsmith/local-server">Test locally</a>}>
+    Run your application on a local server.
+  </Step>
+  <Step title={<a href="/langsmith/application-structure">Configure app for deployment</a>}>
+    Set up dependencies, project structure, and environment configuration.
+  </Step>
+  <Step title={<a href="/langsmith/hosting">Choose hosting</a>}>
+    (Required for deployment) Select Cloud, Hybrid, or Self-hosted.
+  </Step>
+  <Step title="Deploy your app">
+    - [**Cloud**](/langsmith/deploy-to-cloud): Push code from a git repository
+    - [**Hybrid or Self-hosted with control plane**](/langsmith/deploy-with-control-plane): Build and push Docker images, deploy via UI
+    - [**Standalone servers**](/langsmith/deploy-standalone-server): Deploy directly without control plane
+  </Step>
+  <Step title={<a href="/langsmith/observability">Monitor & manage</a>}>
+    Track traces, alerts, and dashboards.
+  </Step>
+</Steps>
 
 ## What you'll learn
 
diff --git a/src/langsmith/local-server.mdx b/src/langsmith/local-server.mdx
index 4883bad139..c6897e34ad 100644
--- a/src/langsmith/local-server.mdx
+++ b/src/langsmith/local-server.mdx
@@ -1,6 +1,6 @@
 ---
 title: Run a LangGraph app locally
-sidebarTitle: Quickstart
+sidebarTitle: Test locally
 ---
 
 This quickstart shows you how to set up a LangGraph application locally for testing and development.

From 636c426f5105de15551a49ec992f139f91af585b Mon Sep 17 00:00:00 2001
From: Kathryn May <kathryn@langchain.dev>
Date: Wed, 29 Oct 2025 13:23:52 -0400
Subject: [PATCH 2/2] Update cloud guide sidebar name

---
 src/langsmith/deploy-to-cloud.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/langsmith/deploy-to-cloud.mdx b/src/langsmith/deploy-to-cloud.mdx
index addd141161..9da48966dd 100644
--- a/src/langsmith/deploy-to-cloud.mdx
+++ b/src/langsmith/deploy-to-cloud.mdx
@@ -1,6 +1,6 @@
 ---
 title: LangSmith on Cloud
-sidebarTitle: Setup guide
+sidebarTitle: Cloud
 icon: "cloud"
 iconType: "solid"
 ---