Skip to content

docs: README pass before 0.1.0 publish#13

Merged
joshrotenberg merged 1 commit intomainfrom
docs/readme-pass-for-0.1.0
Apr 18, 2026
Merged

docs: README pass before 0.1.0 publish#13
joshrotenberg merged 1 commit intomainfrom
docs/readme-pass-for-0.1.0

Conversation

@joshrotenberg
Copy link
Copy Markdown
Contributor

Summary

Pre-publish read-through of the main README.

Changes

  • Install snippet: gen_agent_anthropic constraint bumped from ~> 0.1 to ~> 0.2 (needs :receive_timeout from 0.2.0)
  • Strategies table note: the "see also" link pointed at hexdocs.pm/gen_agent's pattern guides, which doesn't reflect the current layering (orchestration patterns live in this repo now per the ensemble pattern direction). Rewired to point at our own guides/workflows/overview.md.
  • Quickstart: reflects that echo is pre-enabled after chore: re-comment example ensembles in config/config.exs before publishing #2 — no manual config edit needed to try it. Spells out the uncomment-then-restart path for a real ensemble.
  • Workflow guides pointer: listed all 7 strategies (Solo, Switchboard, Pool, Pipeline, Supervisor, Debate, Consensus) instead of just the original 4.
  • Status footer: tightened wording — op vocabulary and public API are stable ahead of 1.0; breaking changes bump minor.
  • Development section: added the full pre-commit checklist that matches CI (format, compile, credo, dialyzer, test).

Test plan

  • mix format --check-formatted clean
  • mix test green (86 tests)
  • mix docs still exits 0 (won't know about 22 warnings until docs: mix docs builds clean, zero warnings #12 merges)
  • Spot-check all internal links still resolve (guides/workflows/*)

Closes #5

- Install snippet: bump gen_agent_anthropic constraint to ~> 0.2
  (uses :receive_timeout from that version)
- Strategies table note: point at the local workflow guides
  instead of the dead link to gen_agent's hexdocs; orchestration
  patterns live here now
- Quickstart: reflect that `echo` is pre-enabled after the
  config re-comment (no manual edit needed to try it), and
  spell out the uncomment-then-restart path for real ensembles
- Per-strategy guide pointer lists all 7 strategies, not just 4
- Status footer tightened: the op vocabulary and public API are
  stable ahead of 1.0, breaking changes bump minor
- Development section adds the full pre-commit checklist that
  matches CI
@joshrotenberg joshrotenberg merged commit 65d0823 into main Apr 18, 2026
2 checks passed
@joshrotenberg joshrotenberg deleted the docs/readme-pass-for-0.1.0 branch April 18, 2026 04:42
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.

docs: README pass before 0.1.0 publish

1 participant