Skip to content

docs: update CLI reference, README, and site docs for v0.23+ features#167

Merged
spboyer merged 1 commit into
mainfrom
docs/update-cli-and-site-docs
Apr 21, 2026
Merged

docs: update CLI reference, README, and site docs for v0.23+ features#167
spboyer merged 1 commit into
mainfrom
docs/update-cli-and-site-docs

Conversation

@spboyer

@spboyer spboyer commented Mar 30, 2026

Copy link
Copy Markdown
Member

Comprehensive docs update: adds missing waza run flags, waza grade/session sections, .waza.yaml reference page, fixes grader descriptions and MDX comment syntax.

- Add 10 missing waza run flags to README (--output-dir, --tags, --model,
  --recommend, --judge-model, --session-log, --session-dir, --no-summary,
  --update-snapshots, --skip-graders)
- Add waza session list/view commands to README
- Add waza grade and waza session sections to site CLI reference
- Add missing waza run flags to site CLI reference
- Create .waza.yaml project configuration reference page
- Fix grader descriptions for tool_constraint and trigger
- Fix trigger_tests → trigger reference in cli.mdx
- Fix HTML comments → MDX comments in eval-yaml.mdx, graders.mdx, schema.mdx

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 30, 2026 20:28
@github-actions github-actions Bot enabled auto-merge (squash) March 30, 2026 20:29

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates the documentation set to reflect newer Waza CLI/config features (v0.23+), including new CLI flags/commands and a new .waza.yaml reference page, plus MDX/cspell comment fixes.

Changes:

  • Added a new .waza.yaml project configuration reference page with section-by-section tables and examples.
  • Expanded the CLI reference and README to cover additional waza run flags plus waza grade and waza session commands.
  • Updated grader documentation text and converted HTML comments to MDX-compatible JSX comments for cspell directives.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
site/src/content/docs/reference/waza-yaml.mdx New .waza.yaml reference page documenting config sections, defaults, and examples
site/src/content/docs/reference/schema.mdx Adjusted cspell ignore directive to MDX JSX comment syntax
site/src/content/docs/reference/cli.mdx Added newer waza run flags and new sections for waza grade and waza session; updated trigger grader naming
site/src/content/docs/guides/graders.mdx Updated grader descriptions and MDX cspell comment syntax
site/src/content/docs/guides/eval-yaml.mdx Updated MDX cspell comment syntax
README.md Expanded CLI flag list and added waza session docs

Comment thread site/src/content/docs/reference/waza-yaml.mdx
Comment thread README.md
@spboyer spboyer merged commit 518d282 into main Apr 21, 2026
10 checks passed
@spboyer spboyer deleted the docs/update-cli-and-site-docs branch April 21, 2026 14:30
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.

3 participants