Skip to content

docs: re-read README, Quickstart, Concepts against v0.6.0#55

Merged
chris-colinsky merged 1 commit into
mainfrom
chore/docs-readread-v0.6
May 19, 2026
Merged

docs: re-read README, Quickstart, Concepts against v0.6.0#55
chris-colinsky merged 1 commit into
mainfrom
chore/docs-readread-v0.6

Conversation

@chris-colinsky
Copy link
Copy Markdown
Member

@chris-colinsky chris-colinsky commented May 19, 2026

Summary

Third of the docs-phase PRs. Editorial re-read of the public docs surface against the 0.6.x feature set, after Examples (PR #54) and the site UX pass (PR #53). No source changes.

  • README. Grammar fix on the engine-features sentence (double "and"). Next-steps Concepts/Examples bullets refreshed to include the 0.6.x topics (parallel branches, LLMs, prompts) and link to docs/examples rather than the GitHub directory.
  • Quickstart. Concepts and Examples link lists refreshed (was missing parallel-branches / llms / prompts / checkpointing; said "five demos" with ten now shipped).
  • concepts/index. Added Prompts; expanded the llms and checkpointing blurbs.
  • concepts/graphs. Added the four 0.6.x builder methods (add_fan_out_node, add_parallel_branches_node, with_checkpointer, with_state_migration) to the methods list.
  • concepts/composition. New "Related composition primitives" section pointing at fan-out and parallel-branches.
  • concepts/fan-out. Switched code samples from the low-level FanOutNode(name=..., config=FanOutConfig(...)) form to the canonical builder.add_fan_out_node(...) API the examples use.
  • concepts/parallel-branches, observability. Em-dash sweep (no-em-dashes-in-prose rule).
  • concepts/llms. New ## Tool calling section between Structured output and Content blocks; refreshed bottom-of-page references to link into docs/examples instead of the GitHub repo.

Audited and left untouched (already accurate against v0.6.x, no em dashes): state-and-reducers.md, checkpointing.md, prompts.md.

Test plan

  • uv run --group docs mkdocs build --strict succeeds
  • concepts/llms.md renders the new Tool calling section between Structured output and Content blocks; code block and cross-link to example 09 work
  • concepts/graphs.md lists the four new builder methods in the methods bullet list, each with a cross-link to its dedicated page
  • concepts/composition.md ends with the new "Related composition primitives" section linking to fan-out and parallel-branches
  • concepts/fan-out.md code samples show builder.add_fan_out_node(...) rather than FanOutNode(name=...)
  • Spot-read concepts/parallel-branches.md and concepts/observability.md for prose flow after em-dash replacements
  • README Next-steps section links land on the right pages

Editorial pass after the 0.6.x feature wave.

- README: grammar fix on the engine-features sentence; Next-steps
  Concepts/Examples bullets updated to include the 0.6.x topics
  (parallel branches, LLMs, prompts) and link to docs/examples
  rather than the GitHub directory.
- Quickstart: Concepts and Examples link lists refreshed (was
  missing parallel-branches/llms/prompts/checkpointing; said
  "five demos" with ten now shipped).
- concepts/index: added Prompts; expanded llms and checkpointing
  blurbs.
- concepts/graphs: added the four 0.6.x builder methods
  (add_fan_out_node, add_parallel_branches_node, with_checkpointer,
  with_state_migration) to the methods list.
- concepts/composition: appended a "Related composition primitives"
  section pointing at fan-out and parallel-branches.
- concepts/fan-out: switched code samples to the canonical
  builder.add_fan_out_node(...) API.
- concepts/parallel-branches, observability: em-dash sweep.
- concepts/llms: new Tool calling section between Structured output
  and Content blocks; refreshed example links to point at
  docs/examples instead of the GitHub repo.

state-and-reducers, checkpointing, and prompts pages audited and
left untouched (already accurate against v0.6.x).
Copilot AI review requested due to automatic review settings May 19, 2026 03:12
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Editorial re-read of public docs against v0.6.0: README/Quickstart next-steps refreshed, concepts index expanded with prompts/checkpointing/multimodal, graphs.md lists new builder methods, composition gets a related-primitives section, fan-out switches to the canonical builder API, and parallel-branches/observability/llms have em-dash sweeps plus a new Tool calling section.

Changes:

  • README + Quickstart next-steps lists refreshed to match the 0.6.x concept/example surface and link to docs/examples.
  • Concepts pages updated: index adds Prompts, graphs.md lists four new builder methods, composition gains "Related composition primitives", fan-out uses builder.add_fan_out_node(...), llms.md adds a Tool calling section.
  • Em-dash sweep across parallel-branches.md and observability.md.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated no comments.

Show a summary per file
File Description
README.md Grammar fix and refreshed Next-steps Concepts/Examples bullets.
docs/getting-started/index.md Quickstart Next list updated to 0.6.x concepts and local examples link.
docs/concepts/index.md Added Prompts; expanded LLMs and Checkpointing blurbs.
docs/concepts/graphs.md Added four new builder methods to the list.
docs/concepts/composition.md New "Related composition primitives" section.
docs/concepts/fan-out.md Switched samples to builder.add_fan_out_node(...).
docs/concepts/parallel-branches.md Em-dash replacements.
docs/concepts/observability.md Em-dash replacements.
docs/concepts/llms.md New Tool calling section; example links point to docs/examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@chris-colinsky chris-colinsky merged commit 472126d into main May 19, 2026
10 checks passed
@chris-colinsky chris-colinsky deleted the chore/docs-readread-v0.6 branch May 19, 2026 03:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants