WIP Draft nav + sidebar updates for langsmith platform #651

katmayb · 2025-09-25T18:17:57Z

This PR updates the docs for LangSmith Platform, folding in LGP. Specifically:

Update to tab arrangement.
Big content changes in Deployments tab (now Agent deployment as well as Platform infrastructure deployment).
Changing the name of the Studio feature.
Overhaul of home page.
Updates to tab landing pages to follow the same card format consistently.
Moving LGP content into the LS directory in the docs.

Latest preview:

https://langchain-5e9cc07a-preview-langsm-1760109143-df9b7ef.mintlify.app/langsmith/home

github-actions · 2025-09-25T18:19:03Z

Preview ID generated: preview-langsm-1758824315-b51cbe2

github-actions · 2025-09-29T19:35:48Z

Preview ID generated: preview-langsm-1759174519-2fcf987

github-actions · 2025-09-29T20:17:03Z

Preview ID generated: preview-langsm-1759176996-f20be3d

github-actions · 2025-10-01T18:08:21Z

Preview ID generated: preview-langsm-1759342075-296f79d

github-actions · 2025-10-01T20:53:03Z

Preview ID generated: preview-langsm-1759351956-78e92d8

github-actions · 2025-10-02T20:52:17Z

Preview ID generated: preview-langsm-1759438309-4bf2e07

github-actions · 2025-10-03T12:44:25Z

Preview ID generated: preview-langsm-1759495425-7827e03

github-actions · 2025-10-03T13:43:02Z

Preview ID generated: preview-langsm-1759498954-167ce7c

github-actions · 2025-10-03T14:02:32Z

Preview ID generated: preview-langsm-1759500119-896821e

andrewnguonly

First, thanks for working on these changes, @katmayb. Here are my latest high-level thoughts that don't apply directly to any specific change in this PR, but is broadly relevant to the overall restructuring.

I couldn't look at every change in the PR. It's too big.
I understand that the primary goal of this PR is to accommodate the product renaming/consolidation and information restructuring. There are some places where I've commented on specific content changes, so feel free to ignore these comments if it's easier to address these in a separate PR.
It might be nice to create some kind of informational banner/page that describes what changes have been made; a doc for the doc changes.
Creating a new Hosting tab feels like the right direction. However, I think it's still challenging to understand that there are different "modules" within LangSmith and that there are different ways to enable/disable them. I will provide some suggestions/ideas for how we could make the content more clear outside of this PR. We may have to make these changes after the launch.

andrewnguonly · 2025-10-13T18:35:29Z

src/langsmith/deployments.mdx

+
+This section covers how to package, build, and deploy your _agents_ and applications.
+
+_Deployment_ focuses on how to build and deploy your graphs (or agentic workflows) as [LangGraph Servers](/langsmith/langgraph-server).


Since LangSmith Deployment literally only supports building and deploying LangGraph OSS graphs, I'd be fine with being more specific/precise here: Deployment focuses on how to build and deploy your LangGraph graphs as LangGraph Servers.

Not blocking.

Side bar: I'm really averse to using "agentic workflows" here because there's been so much discussion/controversy around naming and definitions of things (e.g. OpenAI Dev Day Agent Builder release, Harrison's follow-up blog post). Because of the quickly evolving nature of these things, my preference is that our documentation is dumb and simple and decoupled from this noise. For example, in 6 months, "agentic workflows" might mean something else and/or there will be a new term: "agentic work streams".

I think this is a good point. I removed this instance of "agentic workflows". It would be worthwhile to do a bit of a follow-up on this — I want the docs terminology to be as clear and relevant for as long as possible.

src/langsmith/deployments.mdx

andrewnguonly · 2025-10-13T18:50:39Z

src/langsmith/local-server.mdx

-title: Run a LangGraph application locally
-sidebarTitle: Run a LangGraph application locally
+title: Run a LangGraph app locally
+sidebarTitle: Run a LangGraph app locally


Suggestion: To be consistent with the new hosting.mdx page, LangGraph app --> LangGraph Server

title: Run a LangGraph Server locally sidebarTitle: Run a LangGraph Server locally

There are other places where we use the term app, LangGraph app, and LangGraph application, and LangSmith application. For consistency, should we change all instances to LangGraph Server? I won't comment on all places in this PR. Also, this can probably be done as part of a different PR.

Side bar: I won't comment in all places, but we seem to be using LangGraph Server and LangSmith application interchangeably in the new docs. This is increasing the confusion IMHO. Can we only use 1 term?

Side, side bar: Do we need a Glossary of Terms page? This might be helpful.

src/langsmith/local-server.mdx

andrewnguonly · 2025-10-13T21:48:45Z

src/docs.json

+                        ]
+                      },
+                      {
+                        "group": "Platform components",


Suggestion: Platform components --> Deployment components

The items under this section are only for LangSmith Deployment. Platform feels too wide/vague (for now).

andrewnguonly · 2025-10-13T22:18:48Z

src/labs/oap/quickstart.mdx

    ```

-    You can find your project & tenant IDs with a GET request to the `/info` endpoint on your LangGraph Platform deployment.
+    You can find your project & tenant IDs with a GET request to the `/info` endpoint on your LangSmith deployment.


Nit, but maybe disregard this comment: project & tenant IDs --> deployment (project_id) & workspace IDs (tenant_id)

A long time ago, we used to call deployments, "projects" and we used to call workspaces, "tenants". We never updated the GET /info endpoint. Source code:

async def meta_info(request: ApiRequest): plus = plus_features_enabled() return JSONResponse( { "version": __version__, "langgraph_py_version": langgraph.version.__version__, "flags": { "assistants": True, "crons": plus and config.FF_CRONS_ENABLED, "langsmith": bool(config.LANGSMITH_CONTROL_PLANE_API_KEY) and bool(config.TRACING), "langsmith_tracing_replicas": True, }, "host": { "kind": metadata.HOST, "project_id": metadata.PROJECT_ID, "host_revision_id": metadata.HOST_REVISION_ID, "revision_id": metadata.REVISION, "tenant_id": metadata.TENANT_ID, }, } )

src/labs/oap/setup/agents.mdx

src/langsmith/agent-builder-overview.mdx

src/docs.json

github-actions · 2025-10-14T13:09:34Z

Preview ID generated: preview-langsm-1760447342-72c9244

github-actions · 2025-10-14T14:08:19Z

Preview ID generated: preview-langsm-1760450868-be36abc

github-actions · 2025-10-14T14:15:45Z

Preview ID generated: preview-langsm-1760451311-f04e2be

This PR updates the docs for LangSmith Platform, folding in LGP. Specifically: - Update to tab arrangement. - Big content changes in Deployments tab (now Agent deployment as well as Platform infrastructure deployment). - Changing the name of the Studio feature. - Overhaul of home page. - Updates to tab landing pages to follow the same card format consistently. - Moving LGP content into the LS directory in the docs. ## Latest preview: https://langchain-5e9cc07a-preview-langsm-1760109143-df9b7ef.mintlify.app/langsmith/home

github-actions bot added langsmith For docs changes to LangSmith langgraph-platform For docs changes to LangGraph Platform labels Sep 25, 2025

vercel bot had a problem deploying to Preview September 25, 2025 18:18 Failure

katmayb force-pushed the langsmith-platform branch from 5e4ccf1 to 5c53ec5 Compare September 29, 2025 19:34

vercel bot deployed to Preview September 29, 2025 19:39 View deployment

katmayb force-pushed the langsmith-platform branch from e8aab3b to 9c76609 Compare October 1, 2025 18:07

vercel bot temporarily deployed to Preview October 1, 2025 18:10 Inactive

katmayb force-pushed the langsmith-platform branch 2 times, most recently from a7896cd to 1fa67c3 Compare October 1, 2025 20:51

katmayb force-pushed the langsmith-platform branch from 1fa67c3 to 1c19df5 Compare October 2, 2025 17:22

github-actions bot added langchain For docs changes to LangChain langgraph For docs changes to LangGraph oss javascript labels Oct 2, 2025

katmayb force-pushed the langsmith-platform branch from 0c08343 to 6e19883 Compare October 2, 2025 20:51

katmayb force-pushed the langsmith-platform branch from 6e19883 to 67e123b Compare October 3, 2025 12:43

katmayb force-pushed the langsmith-platform branch from 67e123b to 4eb0e2b Compare October 3, 2025 13:41

github-actions bot added python For content related to the Python version of LangChain projects labs labels Oct 3, 2025

github-actions bot added the docs-infra label Oct 3, 2025

katmayb force-pushed the langsmith-platform branch from b2876e5 to 11305b3 Compare October 3, 2025 16:03

andrewnguonly reviewed Oct 13, 2025

View reviewed changes

katmayb force-pushed the langsmith-platform branch from 89630f5 to 7592722 Compare October 14, 2025 13:08

katmayb marked this pull request as ready for review October 14, 2025 14:06

katmayb added 19 commits October 14, 2025 10:07

Draft nav + sidebar updates for langsmith platform

1eb4767

Work on self-hosted section WIP

0affa6a

Remove more LGP

e71a15c

Update reference content

cc99eee

Refine app dev section

3128dad

Updates

63cf770

Rework deployments tab and sidebar

30b9249

Rework home page and tabs

fc8868a

Update diagram temp

d5bfd21

Make app setup pages more agnostic

444fb9f

Removing studio

4477bf3

Remove more mentions of LGP

d862015

More clean up

ed37cf8

Remove labs, fix debugger

121932b

Deployment + Hosting tabs

17a0dd4

Lauren feedback

0303930

Feedback

c9e112b

Move back to studio

a89489e

Update images + AN feedback

4293425

katmayb force-pushed the langsmith-platform branch from 7592722 to 4293425 Compare October 14, 2025 14:07

Remove groups for reference dropdown

b3c9493

katmayb merged commit 68a794b into main Oct 14, 2025
11 checks passed

katmayb deleted the langsmith-platform branch October 14, 2025 14:21


		This section covers how to package, build, and deploy your _agents_ and applications.

		_Deployment_ focuses on how to build and deploy your graphs (or agentic workflows) as [LangGraph Servers](/langsmith/langgraph-server).

WIP Draft nav + sidebar updates for langsmith platform #651

WIP Draft nav + sidebar updates for langsmith platform #651

Conversation

katmayb commented Sep 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Latest preview:

Uh oh!

github-actions bot commented Sep 25, 2025

Uh oh!

github-actions bot commented Sep 29, 2025

Uh oh!

github-actions bot commented Sep 29, 2025

Uh oh!

github-actions bot commented Oct 1, 2025

Uh oh!

github-actions bot commented Oct 1, 2025

Uh oh!

github-actions bot commented Oct 2, 2025

Uh oh!

github-actions bot commented Oct 3, 2025

Uh oh!

github-actions bot commented Oct 3, 2025

Uh oh!

github-actions bot commented Oct 3, 2025

Uh oh!

andrewnguonly left a comment

Choose a reason for hiding this comment

Uh oh!

andrewnguonly Oct 13, 2025

Choose a reason for hiding this comment

Uh oh!

katmayb Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

andrewnguonly Oct 13, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

andrewnguonly Oct 13, 2025

Choose a reason for hiding this comment

Uh oh!

andrewnguonly Oct 13, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Oct 14, 2025

Uh oh!

github-actions bot commented Oct 14, 2025

Uh oh!

github-actions bot commented Oct 14, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

katmayb commented Sep 25, 2025 •

edited

Loading