Skip to content

docs: bring README, docs site, notebook, and llms exports up to date with v1.1/v1.2 - #172

Merged
johnnichev merged 1 commit into
mainfrom
docs/post-1.2-freshness
Jul 14, 2026
Merged

johnnichev merged 1 commit into
mainfrom
docs/post-1.2-freshness

Conversation

@johnnichev

Copy link
Copy Markdown
Owner

Post-release docs freshness pass after v1.1.0 and v1.2.0:

  • README: banner → v1.2; new What's New sections for v1.2 and v1.1 (same format as prior versions); feature table, bullets, and the Structured Output section updated for native json_schema / structured_status / four-stage guardrails; example-table rows for 23 and 29; test count corrected to the current collected 7,788.
  • docs/index.md: Guardrails card now lists all four stages + observer events.
  • docs/ARCHITECTURE.md: agent responsibilities + structured.py section updated.
  • docs/COOKBOOK.md: the Guardrails Pipeline recipe was broken (five invalid kwargs — GuardrailsPipeline(guardrails=...), GuardrailAction.REDACT, LengthGuardrail(max_length=...), TopicGuardrail(blocked_topics=...), AgentConfig(guardrails=GuardrailsConfig(...)) — it never worked as written). Rewritten against the real API and executed to verify; extended with the tool-boundary stages.
  • docs/QUICKSTART.md: guardrails intro points at the four stages.
  • notebooks/getting_started.ipynb: guardrails cell updated; pre-existing lint debt cleaned (B905 + ruff auto-fixes) since the re-serialization put the notebook in lint scope.
  • docs/llms-full.txt: regenerated (67 pages) via scripts/build_llms_full.py.

docs/llms.txt, GUARDRAILS.md, AGENT.md, CHANGELOG, and the example scripts were already updated in the feature PRs.

https://claude.ai/code/session_01L1JWChKMs9yTyK92qquhJa

…with v1.1/v1.2

Post-release freshness pass:

- README: banner points at v1.2; new "What's New in v1.2" and "v1.1"
  sections; feature table/bullets and the Structured Output section
  reflect native json_schema, structured_status, and the four guardrail
  stages; example table rows 23/29 updated; test count 7,796 -> 7,788.
- docs/index.md: Guardrails card lists the four stages + observer events.
- docs/ARCHITECTURE.md: agent responsibilities and the structured.py
  section reflect native mode, StructuredOutputConfig, structured_status.
- docs/COOKBOOK.md: the Guardrails Pipeline recipe was broken (five
  invalid kwargs; it never worked as written) - rewritten against the
  real API (validated by executing it) and extended with the
  tool-boundary stages.
- docs/QUICKSTART.md: guardrails intro points at the four stages.
- notebooks/getting_started.ipynb: guardrails cell mentions the four
  stages and on_guardrail_triggered; pre-existing lint debt in the
  notebook cleaned (ruff B905 + auto-fixes) since re-serialization put
  it in lint scope.
- docs/llms-full.txt regenerated via scripts/build_llms_full.py.

Claude-Session: https://claude.ai/code/session_01L1JWChKMs9yTyK92qquhJa
@johnnichev
johnnichev merged commit 117cc60 into main Jul 14, 2026
9 checks passed
@johnnichev
johnnichev deleted the docs/post-1.2-freshness branch July 14, 2026 19:26
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.

1 participant