Skip to content

docs(evaluation): Overview revamp#710

Merged
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-overview
Jul 9, 2026
Merged

docs(evaluation): Overview revamp#710
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-overview

Conversation

@YashMohan23

Copy link
Copy Markdown

Evaluation Overview revamped to spec: 156 built-in evals, the template → config → run → score model, 'how it connects' cards, and points to the Running evaluations hub. No ## About, minimal frontmatter, no em-dashes. Draft — part of the batched Evaluation revamp into docs/evaluation-revamp.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@khushalsonawat khushalsonawat marked this pull request as ready for review July 8, 2026 07:16

@khushalsonawat khushalsonawat 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.

Check comments

Comment thread src/pages/docs/evaluation/index.mdx Outdated
title: "Future AGI Evaluation: Measure Prompt and Agent Quality"
description: "Measure and compare the quality of prompts and agents across datasets, simulations, and experiments using built-in or custom eval templates."
title: "Overview"
description: "Evaluations measure how well your AI achieves the user's goal, scored on metrics like accuracy, safety, and tone."

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.

Drop the trailing period on the description

Comment thread src/pages/docs/evaluation/index.mdx Outdated
</Card>
<Card title="Eval groups" icon="table-rows" href="/docs/evaluation">
Bundle multiple evals and run them together.
<Card title="Scores & results" icon="chart-mixed" href="/docs/evaluation/concepts/eval-results">

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.

This concept is Output types in the new sidebar, not Scores & results. Retitle the card when the eval-results rename lands

Comment thread src/pages/docs/evaluation/index.mdx Outdated

## How it connects

Evaluation sits in the middle of Future AGI and feeds on the rest: [Observe](/docs/observe) turns live traces into eval inputs and shows scores back on the trace, datasets and simulations are where offline evals run, optimization consumes scores to improve a prompt, and thresholds become production gates.

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.

Link the first mentions of datasets, simulations, and optimization, same as Observe. Also "feeds on the rest" reads odd

@khushalsonawat

Copy link
Copy Markdown
Contributor

I also need a mental model diagram for the same. Add it in the overview page

@khushalsonawat khushalsonawat self-requested a review July 9, 2026 07:37
@khushalsonawat khushalsonawat merged commit 9f1f63b into docs/evaluation-revamp Jul 9, 2026
@khushalsonawat khushalsonawat deleted the docs/eval-overview branch July 9, 2026 07:37
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.

2 participants