docs(langgraph): eight guides teach through their running examples - #1029
Merged
Conversation
… running examples Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…d copies example source Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Rewrite the streaming guide around the example it embeds: what the demo does, then the graph, provider, and component pulled in with ExampleCode instead of hand-typed copies. The walkthrough is absorbed and deleted. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…one API style throughout Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… receiver name; US spelling Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ref-file note, stream-mode names Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…riant; narrower resume region Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ate; sidebar prose matches its block Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…eturns; the pipeline indicator trails by one node Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
… provider factory, no retired brand in the rendered ref file Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ent contract Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…p promising setBranch forks; page precision Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…e and submit(null) wording aligned Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
blove
enabled auto-merge (squash)
September 6, 2026 01:52
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR 2 of the example-first docs program (spec:
docs/superpowers/specs/2026-09-05-docs-example-first-content-design.md; plan:docs/superpowers/plans/2026-09-06-docs-example-first-langgraph-pilot.md).Pages rewritten (each: what the demo does → how it is built as sequential
<ExampleCode>blocks in build order → concepts the example does not show → What's Next): streaming, persistence, interrupts, memory, durable-execution (was a stub), subgraphs, time-travel, deployment.Walkthroughs deleted: the eight
cockpit/langgraph/*/python/docs/guide.mdfiles (absorbed where they were right; several were wrong about checkpointers and aboutsetBranch, and the pages now follow the code).PENDING_PAGESin the guard drops the eight LangGraph entries (33 remain).Example sources: comment-only
#regionmarkers in six graphs/components; comment/docstring/prompt text fixes where the example promised behavior it does not have (time-travelsetBranch, subgraphs ref-file comment). No executable line changed; both deployment generators produce no diff.Facts corrected along the way (each verified against
libs/langgraph/libs/chatsource):submit(null)resumes only pending work;retry()/reload()semantics;AgentErrorfields;provideAgent({ config })does not exist (configis a submit option);setBranch()is a client-side pointer, a fork issubmit(input, { checkpoint });langgraph devrefuses a self-compiled checkpointer while a deployment ignores it.New e2e:
apps/website/e2e/example-code.spec.tsproves a rendered<ExampleCode>block is highlighted, titled, and copies exactly thepretext; runs in the production-verify step too.Verification:
nx run-many -t test,lintgreen (website, cockpit-registry, cockpit-shell, scripts); generators no drift; prod build renders every page withdata-example-filecounts equal to its tag counts;nx e2e website123 passed.Follow-ups (not here): the durable-execution
generatenode takesstate["messages"][-1](the plan's response) as the "user" turn; the time-travel Fork button is a second Replay; the memory example's docstrings still say "cross-thread"; the registry's Angular descriptor for deployment-runtime points at a file that does not exist;CodeGroupstill cannot tabExampleCodeblocks.🤖 Generated with Claude Code