Updates to self-hosted LS deployments (#1191)

This PR adds more description to the self-hosted LS pages.

## Preview


https://langchain-5e9cc07a-preview-hostin-1761918170-b5e32bd.mintlify.app/langsmith/self-hosted

Author: katmayb

src/langsmith/components.mdx

@@ -4,7 +4,7 @@ sidebarTitle: Overview
 mode: wide
 ---
 
-When running the self-hosted [LangSmith with deployment](/langsmith/deploy-self-hosted-full-platform), your installation includes several key components. Together these tools and services provide a complete solution for building, deploying, and managing graphs (including agentic applications) in your own infrastructure:
+When running self-hosted [LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform), your installation includes several key components. Together these tools and services provide a complete solution for building, deploying, and managing graphs (including agentic applications) in your own infrastructure:
 
 ```mermaid
 flowchart

src/langsmith/deploy-self-hosted-full-platform.mdx

@@ -1,25 +1,27 @@
 ---
-title: Self-host LangSmith with deployment
-sidebarTitle: With deployment
+title: Enable LangSmith Deployment
+sidebarTitle: Enable deployment
 icon: "server"
 ---
 
-This guide shows you how to enable **deployment management** on your self-hosted LangSmith instance. This adds a [control plane](/langsmith/control-plane) and [data plane](/langsmith/data-plane) that let you deploy, scale, and manage agents and applications directly through the LangSmith UI.
+This guide shows you how to enable **LangSmith Deployment** on your [self-hosted LangSmith instance](/langsmith/kubernetes). This adds a [control plane](/langsmith/control-plane) and [data plane](/langsmith/data-plane) that let you deploy, scale, and manage agents and applications directly through the LangSmith UI.
 
-<Info>**Important**<br></br> Self-hosting LangSmith with deployment requires an [Enterprise](https://langchain.com/pricing) plan. </Info>
+After completing this guide, you'll have access to LangSmith [Observability](/langsmith/observability), [Evaluation](/langsmith/evaluation), and [Deployment](/langsmith/deployments).
+
+<Info>**Important**<br></br> Enabling LangSmith Deployment requires an [Enterprise](https://langchain.com/pricing) plan. </Info>
 
 <Note>
-**This setup page is for adding [deployment](/langsmith/deployments) capabilities to an existing LangSmith instance.**
+**This setup page is for enabling [LangSmith Deployment](/langsmith/deployments) on an existing LangSmith instance.**
 
 Review the [self-hosted options](/langsmith/self-hosted) to understand:
 - [LangSmith (observability)](/langsmith/self-hosted#langsmith): What you should install first.
-- [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment): What this guide enables.
+- [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment): What this guide enables.
 - [Standalone Server](/langsmith/self-hosted#standalone-server): Lightweight alternative without the UI.
 </Note>
 
 ## Overview
 
-This guide builds on top of the [Kubernetes installation guide](/langsmith/kubernetes). **You must complete that guide first** before continuing. This page covers the additional setup steps required to enable deployment functionality:
+This guide builds on top of the [Kubernetes installation guide](/langsmith/kubernetes). **You must complete that guide first** before continuing. This page covers the additional setup steps required to enable LangSmith Deployment:
 - Installing the LangGraph operator
 - Configuring your ingress
 - Connecting to the control plane

src/langsmith/deploy-standalone-server.mdx

@@ -11,7 +11,7 @@ This guide shows you how to deploy **standalone <Tooltip tip="The server that ru
 
 This deployment option provides flexibility but requires you to manage your own infrastructure and configuration. Each environment can vary significantly and, as a result, troubleshooting configuration issues may be challenging.
 
-For production workloads, we recommend [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment), which offers standardized deployment patterns and more comprehensive support options.
+For production workloads, we recommend [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment), which offers standardized deployment patterns and more comprehensive support options.
 </Warning>
 
 <Note>
@@ -20,7 +20,7 @@ For production workloads, we recommend [LangSmith with deployment](/langsmith/se
 Review the [self-hosted options](/langsmith/self-hosted) to understand:
 - [Standalone Server](/langsmith/self-hosted#standalone-server): What this guide covers (no UI, just servers).
 - [LangSmith](/langsmith/self-hosted#langsmith): For the full LangSmith platform with UI.
-- [LangSmith with deployment](/langsmith/self-hosted#langsmith-with-deployment): For UI-based deployment management.
+- [LangSmith Deployment](/langsmith/self-hosted#langsmith-deployment): For UI-based deployment management.
 
 Before continuing, review the [standalone server overview](/langsmith/self-hosted#standalone-server).
 </Note>

src/langsmith/deploy-with-control-plane.mdx

@@ -11,7 +11,7 @@ This guide shows you how to deploy your applications to [hybrid](/langsmith/hybr
 
 Before using this guide, you must have already completed infrastructure setup:
 - **[Hybrid setup](/langsmith/deploy-hybrid)**: For hybrid hosting.
-- **[Self-hosted with deployment setup](/langsmith/deploy-self-hosted-full-platform)**: For self-hosted with control plane.
+- **[Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform)**: For self-hosted with control plane.
 
 If you haven't set up your infrastructure yet, start with the [Hosting section](/langsmith/hosting).
 </Note>
@@ -31,8 +31,8 @@ Before completing this guide, you'll need the following:
 
 - Completed infrastructure setup to enable your [data plane](/langsmith/data-plane) to receive application deployments:
   - [Hybrid setup](/langsmith/deploy-hybrid): Installs data plane components (listener, operator, CRDs) in your Kubernetes cluster that connect to LangChain's managed control plane.
-  - [Self-hosted with deployment setup](/langsmith/deploy-self-hosted-full-platform): Enables deployment management on your self-hosted LangSmith instance.
-- Access to the [LangSmith UI](https://smith.langchain.com) with deployment management enabled.
+  - [Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform): Enables LangSmith Deployment on your self-hosted LangSmith instance.
+- Access to the [LangSmith UI](https://smith.langchain.com) with LangSmith Deployment enabled.
 - A container registry accessible by your Kubernetes cluster.
 
 ## Step 1. Test locally

src/langsmith/hosting.mdx

@@ -4,7 +4,7 @@ sidebarTitle: Hosting LangSmith
 mode: wide
 ---
 
-This section covers how to host and manage LangSmith infrastructure. You have the flexibility of setting up LangSmith for [observability](/langsmith/observability), [evaluation](/langsmith/evaluation), and [prompt engineering](/langsmith/prompt-engineering) features or using the full platform that also includes optional [LangSmith Deployment](/langsmith/deployments) features for deploying your applications through the UI.
+This section covers how to host and manage LangSmith infrastructure. You can set up LangSmith for [observability](/langsmith/observability), [evaluation](/langsmith/evaluation), and [prompt engineering](/langsmith/prompt-engineering), or use the full platform experience with [LangSmith Deployment](/langsmith/deployments) to also deploy and manage your applications through the UI.
 
 <Callout icon="building" color="#2563EB" iconType="regular">
 **Start here if you're setting up or maintaining LangSmith infrastructure.**
@@ -46,7 +46,7 @@ You'll deploy LangSmith in one of three modes:
     href="/langsmith/self-hosted"
     cta="Run self-hosted"
   >
-    **(Enterprise)** Full control with observability, evaluation, and prompt engineering. Optionally add application deployment or run standalone servers.
+    **(Enterprise)** Full control with observability, evaluation, and prompt engineering. Enable the full platform experience with LangSmith Deployment or run standalone servers.
   </Card>
 </Columns>
 
@@ -59,7 +59,7 @@ Refer to the following table for a comparison of hosting options:
 | **Infrastructure location** | LangChain's cloud | Split: Control plane in LangChain cloud, data plane in your cloud | Your cloud |
 | **Who manages updates** | LangChain | LangChain (control plane), You (data plane) | You |
 | **Who manages CI/CD for your apps** | LangChain | You | You |
-| **Can deploy applications?** | ✅ Yes | ✅ Yes | ✅ Yes (with full platform option) |
+| **Can deploy applications?** | ✅ Yes | ✅ Yes | ✅ Yes (with LangSmith Deployment) |
 | **Observability data location** | LangChain cloud | LangChain cloud | Your cloud |
 | **[Pricing](https://www.langchain.com/plans)** | Plus tier | Enterprise | Enterprise |
 | **Best for** | Quick setup, managed infrastructure | Data residency requirements + managed control plane | Full control, data isolation |

src/langsmith/kubernetes.mdx

@@ -7,29 +7,26 @@ sidebarTitle: Install on Kubernetes
 Self-hosting LangSmith is an add-on to the Enterprise Plan designed for our largest, most security-conscious customers. See our [pricing page](https://www.langchain.com/pricing) for more detail, and [contact our sales team](https://www.langchain.com/contact-sales) if you want to get a license key to trial LangSmith in your environment.
 </Info>
 
-This page describes how to set up the **LangSmith** (observability, tracing, and evaluation) in a Kubernetes cluster. You'll use Helm to install LangSmith and its dependencies.
-
-<Note>
-This guide installs the base [LangSmith platform](/langsmith/self-hosted#langsmith) which includes observability and evaluation, but **not** the deployment management features. Review the [self-hosted options](/langsmith/self-hosted) if you're unsure which you need.
-</Note>
+This page describes how to set up **LangSmith** (observability, tracing, and evaluation) in a Kubernetes cluster. You'll use Helm to install LangSmith and its dependencies.
 
 After completing this page, you'll have:
 
-- ✅ **LangSmith UI and APIs**: for observability, tracing, and evaluation.
-- ✅ **Backend services**: (queue, playground, ACE).
-- ✅ **Datastores**: (PostgreSQL, Redis, ClickHouse, optional blob storage).
-- ❌ **Deployment management**: To add deployment capabilities, complete this guide first, then follow [Self-host LangSmith with deployment](/langsmith/deploy-self-hosted-full-platform).
+- **LangSmith UI and APIs**: for [observability](/langsmith/observability), tracing, and [evaluation](/langsmith/evaluation).
+- **Backend services**: (queue, playground, ACE).
+- **Datastores**: (PostgreSQL, Redis, ClickHouse, optional blob storage).
+
+For [agent deployment](/langsmith/deployments): To add deployment capabilities, complete this guide first, then follow [Enable LangSmith Deployment](/langsmith/deploy-self-hosted-full-platform).
 
-We've successfully tested LangSmith on the following Kubernetes distributions:
+LangChain has successfully tested LangSmith on the following Kubernetes distributions:
 
-* Google Kubernetes Engine (GKE)
-* Amazon Elastic Kubernetes Service (EKS)
-* Azure Kubernetes Service (AKS)
-* OpenShift (4.14+)
-* Minikube and Kind (for development purposes)
+- Google Kubernetes Engine (GKE)
+- Amazon Elastic Kubernetes Service (EKS)
+- Azure Kubernetes Service (AKS)
+- OpenShift (4.14+)
+- Minikube and Kind (for development purposes)
 
 <Note>
-We have several Terraform modules the help in the provisioning of resources for LangSmith. You can find those in our [public Terraform repo](https://github.com/langchain-ai/terraform).
+LangChain has several Terraform modules the help in the provisioning of resources for LangSmith. You can find those in the LangChain [public Terraform repo](https://github.com/langchain-ai/terraform).
 
 Supported cloud providers include: