langchain-ai/langgraph
1
0
Fork 0
mirror of https://github.com/langchain-ai/langgraph.git synced 2026-07-15 12:35:43 -04:00
Code Issues 314 Packages Projects Releases 17 Wiki Activity

[PR #4118] docs: Refactor content for new LangGraph Platform deployment options #3654

New Issue
Closed
opened 2026-02-20 17:48:57 -05:00 by yindo · 0 comments
yindo commented 2026-02-20 17:48:57 -05:00
Owner
Copy Link
Copy Source

Original Pull Request: https://github.com/langchain-ai/langgraph/pull/4118

State: closed
Merged: Yes

Summary

This is a large refactor of the content for the LangGraph Platform deployment options. Although there are a lot of changes, I do feel fairly confident that this is safe to merge and won't have any negative impact related to confusion around deployment options. However, please review thoroughly (i.e. run the docs locally).

Goals and Non-Goals

Just wanted to explicitly state goals and non-goals so that we're clear about what needs to be done now versus what can be done in a smaller follow-up PR.

Goals

  1. Add new content for the new deployment options (Self-Hosted Data Plane, Self-Hosted Control Plane).
  2. Hide old content for deprecated deployment options (BYOC).
  3. Create a pair of "conceptual" and "how-to" pages for each deployment option. As much as possible, the pages should have consistent headings.
  4. Introduce the terms "control plane" and "data plane" and define them plainly without hiding/abstracting information.

Non-Goals

  1. Do not change the navigation of the existing deployment options. As much as possible, update content in-place or add new pages. Changing the navigation is a bigger task that can be done later.
  2. Do not remove old content for deprecated deployment options. We may need to refer to this later. There are only ~2 pages (I think).

Next Steps

  1. Update the architecture diagrams for each deployment option. Commit Excalidraw file to source control.
  2. Create a "how-to" page for the Control Plane UI. This page pertains to 3/4 deployment options. Most of the content lives in the "how-to" page for Cloud SaaS deployment.
  3. Document required RBAC permissions for K8s for Self-Hosted Data Plane and Self-Hosted Control Plane (and update links).
  4. Figure out how to consolidate plan information.
  5. Figure out where to document licensing, telemetry, custom Postgres/Redis.
  6. Update autoscaling content.
  7. Add "alpha" label to deployment options.
  8. Document benchmarks.
**Original Pull Request:** https://github.com/langchain-ai/langgraph/pull/4118 **State:** closed **Merged:** Yes --- ### Summary This is a large refactor of the content for the LangGraph Platform deployment options. Although there are a lot of changes, I do feel fairly confident that this is safe to merge and won't have any negative impact related to confusion around deployment options. However, please review thoroughly (i.e. run the docs locally). ### Goals and Non-Goals Just wanted to explicitly state goals and non-goals so that we're clear about what needs to be done now versus what can be done in a smaller follow-up PR. Goals 1. Add new content for the new deployment options (Self-Hosted Data Plane, Self-Hosted Control Plane). 1. Hide old content for deprecated deployment options (BYOC). 1. Create a pair of "conceptual" and "how-to" pages for each deployment option. As much as possible, the pages should have consistent headings. 1. Introduce the terms "control plane" and "data plane" and define them plainly without hiding/abstracting information. Non-Goals 1. Do not change the navigation of the existing deployment options. As much as possible, update content in-place or add new pages. Changing the navigation is a bigger task that can be done later. 1. Do not remove old content for deprecated deployment options. We may need to refer to this later. There are only ~2 pages (I think). ### Next Steps 1. Update the architecture diagrams for each deployment option. Commit Excalidraw file to source control. 1. Create a "how-to" page for the Control Plane UI. This page pertains to 3/4 deployment options. Most of the content lives in the "how-to" page for Cloud SaaS deployment. 1. Document required RBAC permissions for K8s for Self-Hosted Data Plane and Self-Hosted Control Plane (and update links). 1. Figure out how to consolidate plan information. 1. ~~Figure out where to document licensing, telemetry, custom Postgres/Redis.~~ 1. ~~Update autoscaling content.~~ 1. ~~Add "alpha" label to deployment options.~~ 1. Document benchmarks.
yindo added the pull-request label 2026-02-20 17:48:57 -05:00
yindo closed this issue 2026-02-20 17:48:57 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
agents
awaiting author revision
bug
change
chat models
checkpointer
ci
code quality
code quality
dependencies
documentation
drawing
duplicate
enhancement
good first issue
help wanted
invalid
maintainer
meta
missing information
not maintained by langchain
open-swe-auto
open-swe-max
open-swe-max-auto
pending
performance
pull-request
Mirrored from GitHub Pull Request
 question
requires design
sdk
server
stale
studio
tests
type checking
usage question
v0.5
v1.1
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langgraph#3654
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?