Sweep docs em dashes and stale refs

[chris-colinsky]

Summary

Third of five docs-polish items. Deep docs sweep, audit-first.

Three definite stale references fixed:

• docs/examples/10-langfuse-observability.md: example trace output's spec_version='0.26.0' now reads '0.38.0' (current pinned spec).
• docs/concepts/parallel-branches.md: dropped the dangling v0.16.1 qualifier from the retry attempt_index propagation reference. The behavior is current; the version pin was leftover from when the proposal landed.
• docs/agent/non-obvious-shapes.md: compiled.attach_observer corrected to graph.attach_observer for variable-name consistency with every other example in the docs.

Em-dash sweep:

130 em dashes removed across 17 user-facing docs, per the convention set during PR #111's patterns expansion. Replacements were contextual (colons, semicolons, restructured asides) rather than mechanical; reference sections that listed cross-links as [link] -- description now use [link]: description, inline emphasis dashes drop into the surrounding clause.

The two highest-em-dash files (docs/agent/non-obvious-shapes.md at 30, docs/concepts/observability.md at 28) saw the most prose restructuring. mkdocs strict build remains clean post-sweep.

Deferred:

Spec section-number references (e.g. observability §5.5, §8.4.1, §8.6) intentionally not verified against the current v0.38.0 submodule. Worth a spot-check at next spec-bump release prep when we'd be touching the submodule anyway.

Test plan

• uv run pytest -q (1080 pass, no regressions; drift test green after AGENTS.md regen)
• uv run mkdocs build --strict clean (no broken intra-docs links)
• ruff check + ruff format --check clean
• No em dashes remaining in docs/
• Local mkdocs serve and skim the highest-restructured pages (non-obvious-shapes.md, observability.md) for any prose that reads broken

Out of scope

• Spec § verification (deferred to next spec-bump release prep).
• Items 4-5 of the docs-polish sweep (README pointer-block thinning, version on homepage). Separate PRs.

[Copilot]

Pull request overview

Docs polish sweep: removes em dashes from user-facing docs (replacing with colons/semicolons/restructured prose) and fixes three stale references (spec version, dangling version qualifier, variable-name typo). The bundled AGENTS.md is regenerated to match.

Changes:

• Replaced ~130 em dashes across 17 docs with contextual punctuation (colons, semicolons, parenthetical asides).
• Fixed stale refs: spec_version='0.26.0' → '0.38.0'; dropped v0.16.1 qualifier; compiled.attach_observer → graph.attach_observer.
• Regenerated src/openarmature/AGENTS.md and updated CHANGELOG.

Reviewed changes

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

Show a summary per file

File	Description
CHANGELOG.md	Documents the docs sweep under Unreleased/Changed.
docs/agent/non-obvious-shapes.md	Em-dash sweep plus graph.attach_observer fix.
docs/agent/tldr.md	Em-dash → colon in TL;DR.
docs/concepts/checkpointing.md	Em-dash → colon/period.
docs/concepts/fan-out.md	Em-dash → semicolon/colon.
docs/concepts/llms.md	Em-dashes → colons in bullets/comments.
docs/concepts/observability.md	Largest restructuring; em-dashes → colons/semicolons.
docs/concepts/parallel-branches.md	Drops stale v0.16.1 qualifier.
docs/concepts/prompts.md	Em-dash → colon.
docs/concepts/state-and-reducers.md	Em-dash → colon.
docs/examples/07-multimodal-prompt.md	Em-dash → semicolon/period.
docs/examples/10-langfuse-observability.md	Updates spec_version to 0.38.0 and em-dash sweep.
docs/model-providers/authoring.md	Em-dash → colon in link text.
docs/model-providers/vllm.md	Em-dash sweep across headings/comments.
docs/patterns/*.md	Em-dash sweep across pattern docs.
src/openarmature/_patterns/*.md	Em-dash sweep in bundled pattern sources.
src/openarmature/AGENTS.md	Regenerated to reflect docs changes.

---

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