[docs] Update documentation for 2026-04-02 features

[github-actions]

Documentation Updates — 2026-04-02

This PR updates the documentation based on features merged in the last 24 hours and addresses open documentation issues.

Features Documented

• engine.token-weights frontmatter option (from feat: add custom model token weights in engine frontmatter #24134) — New section in engines.md covering multipliers and token-class-weights with a usage example; frontmatter-full.md updated with the full schema
• AWF memory default (6g) — frontmatter-full.md now explicitly states the 6g default instead of "AWF's default" (closes Docs: clarify default AWF memory limit (6g) #23950)
• Audit command reference page — New reference/audit.md covering all three subcommands (gh aw audit, gh aw audit diff, gh aw audit report) with flags, examples, and output descriptions (closes docs: add audit command reference page #23957)
• Quick Start improvements — Added frontmatter definition on first use; clarified that COPILOT_GITHUB_TOKEN is distinct from GITHUB_TOKEN (from [plan] Fix documentation issues from noob tester audit (discussion #24114) #24115)
• Cross-references for audit — Added audit diff/audit report examples and a link to the new audit reference page in debugging.md; added audit links to cost-management.md related docs section

Detailed Changes & References

Changes Made

• docs/src/content/docs/reference/engines.md — Added "Custom Token Weights (token-weights)" section
• docs/src/content/docs/reference/frontmatter-full.md — Added token-weights to engine Option 2 schema; fixed memory default comment to say 6g
• docs/src/content/docs/reference/audit.md — New file: complete reference for gh aw audit, gh aw audit diff, gh aw audit report
• docs/src/content/docs/reference/cost-management.md — Updated tip to mention audit report for trends; added audit and effective-tokens to Related Documentation
• docs/src/content/docs/setup/quick-start.mdx — Linked "frontmatter" definition on first use; clarified COPILOT_GITHUB_TOKEN distinction
• docs/src/content/docs/troubleshooting/debugging.md — Added audit diff and audit report examples with link to new audit reference

Merged PRs Referenced

• feat: add custom model token weights in engine frontmatter #24134 — feat: add custom model token weights in engine frontmatter
• feat: add effective token template expressions to all footer templates #24150 — feat: add effective token template expressions to all footer templates
• feat: implement Effective Tokens specification in Go #24122 — feat: implement Effective Tokens specification in Go

Open Issues Addressed

• Docs: clarify default AWF memory limit (6g) #23950 — Docs: clarify default AWF memory limit (6g)
• docs: add audit command reference page #23957 — docs: add audit command reference page
• [plan] Fix documentation issues from noob tester audit (discussion #24114) #24115 — [plan] Fix documentation issues from noob tester audit (quick win items)

Notes

• The effective token template variables ({effective_tokens}, {effective_tokens_formatted}, {effective_tokens_suffix}) were already documented in safe-outputs.md and footers.md by PR feat: add effective token template expressions to all footer templates #24150 — no additional changes needed there.
• Issue docs: enhance existing pages with audit cross-references and glossary entries #23959 (audit cross-references and glossary entries) is partially addressed; full glossary additions (Audit, Audit diff, etc.) are left for a follow-up.
• Issue [plan] Fix documentation issues from noob tester audit (discussion #24114) #24115 items 1, 4, 5, 6, 7, 8 (sitemap fix, nav renaming, Examples link, GHES reordering, early-access warning, add-wizard sample output) require changes to astro.config.* or structural nav changes — those are beyond scope for a pure docs PR.

Generated by Daily Documentation Updater · ● 566.8K · ◷

• expires on Apr 3, 2026, 8:35 PM UTC