Skip to content

docs(site): fix model example and expand docs-site dev section#1363

Merged
jamesadevine merged 1 commit into
mainfrom
docs/site-local-dev-and-engine-accuracy-eb22b8e4078efd7a
Jul 7, 2026
Merged

docs(site): fix model example and expand docs-site dev section#1363
jamesadevine merged 1 commit into
mainfrom
docs/site-local-dev-and-engine-accuracy-eb22b8e4078efd7a

Conversation

@github-actions

@github-actions github-actions Bot commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixes a stale model identifier in the engine reference so example code matches what the compiler actually knows about.
  • Replaces a vague one-liner about "your usual Astro workflow" with a concrete, step-by-step docs-site development section, including dev server URL, the faster build:astro shortcut, and a note about the full build command's Playwright/slides step.

Changes

  • site/src/content/docs/reference/engine.mdx — corrected the model field example from claude-sonnet-4.7 (does not appear in the catalog) to claude-sonnet-4.5 (the registered alternative in src/inspect/catalog.rs and prompts/create-ado-agentic-workflow.md).
  • site/src/content/docs/setup/local-development.mdx — replaced the vague trailing sentence with a proper "Work on the docs site" section: npm ci, npm run dev (live at localhost:4321/ado-aw/), npm run build:astro for full validation, and a note explaining when build vs build:astro is appropriate.

Accuracy checks

  • claude-sonnet-4.5 verified in src/inspect/catalog.rs (models() function, line 283) and in prompts/create-ado-agentic-workflow.md step 2 model table.
  • claude-sonnet-4.7 does not appear anywhere else in site/src/ — this was the only occurrence.
  • Docs-site dev commands verified against site/package.json (dev, build:astro, build scripts) and site/slides/package.json (confirms Playwright dependency for the full build).

Validation

  • cd site && npm ci && npm run build:astro — 38 pages built, all internal links valid.
  • README not touched — no README re-read required.

Created by the docs-writer workflow.

Generated by Docs Writer · 226.6 AIC · ⌖ 13.5 AIC · ⊞ 7.6K ·

- engine.mdx: correct the example model from claude-sonnet-4.7 to
  claude-sonnet-4.5, matching the registered catalog (src/inspect/catalog.rs)
  and the create-ado-agentic-workflow.md prompt reference table.
- local-development.mdx: replace the vague 'run the site with your usual
  Astro workflow' line with a concrete step-by-step section: npm ci,
  npm run dev (localhost:4321), npm run build:astro, and a note explaining
  when to use build vs build:astro (Playwright/slides step).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot mentioned this pull request Jul 6, 2026
@jamesadevine jamesadevine marked this pull request as ready for review July 7, 2026 14:10
@jamesadevine jamesadevine reopened this Jul 7, 2026
@jamesadevine jamesadevine merged commit a72eb86 into main Jul 7, 2026
14 checks passed
@jamesadevine jamesadevine deleted the docs/site-local-dev-and-engine-accuracy-eb22b8e4078efd7a branch July 7, 2026 14: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.

1 participant