langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-23 12:55:40 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[GH-ISSUE #974] Production LangGraph docs replaced by v1-alpha — major disruption for existing users #121

New Issue
Closed
opened 2026-02-17 17:19:13 -05:00 by yindo · 3 comments
yindo commented 2026-02-17 17:19:13 -05:00
Owner
Copy Link
Copy Source

Originally created by @IanDoesTech on GitHub (Oct 17, 2025).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/974

The LangGraph documentation for the production version (https://docs.langchain.com/oss/python/langgraph
) was recently replaced with the v1-alpha documentation. Unfortunately, this has created a few serious issues for current users:

Many production-ready LangGraph docs are now missing or inaccessible. (I was working my way through the guides and finding them invaluable!)

The v1-alpha docs refer to an unreleased or experimental version, which is not yet suitable for production.

Developers maintaining production systems now have limited stable documentation reference for the existing version.

Why this matters:

Not everyone can migrate immediately to v1-alpha.

Active teams maintaining production workflows now face blockers in updating or debugging their existing code.

Even a temporary doc archive (e.g., /v0/ or /legacy/) would solve this issue elegantly.

Suggested solution:

Please restore the production docs under a stable URL (e.g., /v0/ or /stable/).

Alternatively, publish a link to a static archive of the previous version (e.g., via GitHub Pages).

Thanks for all your hard work on LangGraph — the tool is amazing, and a stable doc version would really help the community maintain their existing systems while v1-alpha evolves. 🙏

Originally created by @IanDoesTech on GitHub (Oct 17, 2025). Original GitHub issue: https://github.com/langchain-ai/docs/issues/974 The LangGraph documentation for the production version (https://docs.langchain.com/oss/python/langgraph ) was recently replaced with the v1-alpha documentation. Unfortunately, this has created a few serious issues for current users: Many production-ready LangGraph docs are now missing or inaccessible. (I was working my way through the guides and finding them invaluable!) The v1-alpha docs refer to an unreleased or experimental version, which is not yet suitable for production. Developers maintaining production systems now have limited stable documentation reference for the existing version. Why this matters: Not everyone can migrate immediately to v1-alpha. Active teams maintaining production workflows now face blockers in updating or debugging their existing code. Even a temporary doc archive (e.g., /v0/ or /legacy/) would solve this issue elegantly. Suggested solution: Please restore the production docs under a stable URL (e.g., /v0/ or /stable/). Alternatively, publish a link to a static archive of the previous version (e.g., via GitHub Pages). Thanks for all your hard work on LangGraph — the tool is amazing, and a stable doc version would really help the community maintain their existing systems while v1-alpha evolves. 🙏
yindo closed this issue 2026-02-17 17:19:13 -05:00
yindo commented 2026-02-17 17:19:13 -05:00
Author
Owner
Copy Link
Copy Source

@mdrxy commented on GitHub (Oct 17, 2025):

Replied here - but TL;DR the new docs are production ready, along with v1 releases. If needed, you can access the old docs for a short period longer, though they are marked for removal. Please open further issues if you encounter missing content or if existing content is difficult to find.

@mdrxy commented on GitHub (Oct 17, 2025): Replied [here](https://github.com/langchain-ai/docs/issues/971#issuecomment-3417298306) - but TL;DR the new docs are production ready, along with v1 releases. If needed, you can access the old docs for a short period longer, though they are marked for removal. Please open further issues if you encounter missing content or if existing content is difficult to find.
yindo commented 2026-02-17 17:19:13 -05:00
Author
Owner
Copy Link
Copy Source

@IanAtDazed commented on GitHub (Oct 18, 2025):

Ok, at the time I posted that, the new docs were still labelled as "v1-alpha". I'm glad the new release is production ready, and I'm looking forward to using it. However, many teams won't be able to immediately make the leap. For example, my project heavily relies on CopilotKit, and it appears that it isn't compatible with the new LangChain yet. It looks as though there is a similar situation with Langfuse. I’m sure there are others. Who knows how long it will be before they’re all compatible. Having permanent access to the original docs would make life easier for everyone who might find themselves stuck having to use the old version of LangChain/LangGraph for the foreseeable future. Please reconsider removing the old docs. I’m sure many of your users would thank you for it.

@IanAtDazed commented on GitHub (Oct 18, 2025): Ok, at the time I posted that, the new docs were still labelled as "v1-alpha". I'm glad the new release is production ready, and I'm looking forward to using it. However, many teams won't be able to immediately make the leap. For example, my project heavily relies on CopilotKit, and it appears that it isn't compatible with the new LangChain yet. It looks as though there is a similar situation with Langfuse. I’m sure there are others. Who knows how long it will be before they’re all compatible. Having permanent access to the original docs would make life easier for everyone who might find themselves stuck having to use the old version of LangChain/LangGraph for the foreseeable future. Please reconsider removing the old docs. I’m sure many of your users would thank you for it.
yindo changed title from Production LangGraph docs replaced by v1-alpha — major disruption for existing users to [GH-ISSUE #974] Production LangGraph docs replaced by v1-alpha — major disruption for existing users 2026-06-05 17:25:11 -04:00
yindo commented 2026-06-05 17:25:12 -04:00
Author
Owner
Copy Link
Copy Source

@IanDoesTech commented on GitHub (Oct 18, 2025):

Ok, at the time I posted that, the new docs were still labelled as "v1-alpha". I'm glad the new release is production ready, and I'm looking forward to using it. However, many teams won't be able to immediately make the leap. For example, my project heavily relies on CopilotKit, and it appears that it isn't compatible with the new LangChain yet. It looks as though there is a similar situation with Langfuse. I’m sure there are others. Who knows how long it will be before they’re all compatible. Having permanent access to the original docs would make life easier for everyone who might find themselves stuck having to use the old version of LangChain/LangGraph for the foreseeable future. Please reconsider removing the old docs. I’m sure many of your users would thank you for it.

<!-- gh-comment-id:3418471126 --> @IanDoesTech commented on GitHub (Oct 18, 2025): Ok, at the time I posted that, the new docs were still labelled as "v1-alpha". I'm glad the new release is production ready, and I'm looking forward to using it. However, many teams won't be able to immediately make the leap. For example, my project heavily relies on CopilotKit, and it appears that it isn't compatible with the new LangChain yet. It looks as though there is a similar situation with Langfuse. I’m sure there are others. Who knows how long it will be before they’re all compatible. Having permanent access to the original docs would make life easier for everyone who might find themselves stuck having to use the old version of LangChain/LangGraph for the foreseeable future. Please reconsider removing the old docs. I’m sure many of your users would thank you for it.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label
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/docs#121
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?