Skip to content

Evaluation revamp docs#719

Merged
75 commits merged into
devfrom
docs/evaluation-revamp
Jul 10, 2026
Merged

Evaluation revamp docs#719
75 commits merged into
devfrom
docs/evaluation-revamp

Conversation

@khushalsonawat

Copy link
Copy Markdown
Contributor

Pull Request

Description

Describe the changes in this pull request:

  • What feature/bug does this PR address?
  • Provide any relevant links or screenshots.

Checklist

  • Code compiles correctly.
  • Created/updated tests.
  • Linting and formatting applied.
  • Documentation updated.

Related Issues

Closes #<issue_number>

@khushalsonawat khushalsonawat self-assigned this Jul 8, 2026
khushalsonawat and others added 19 commits July 8, 2026 17:02
docs(evaluation): Eval types (three types)
docs(evaluation): Composite evals & groups (concept)
Repoints the judge-model card to concepts/judge-models, where that
content now lives after a84dce3 folded it in.
…ation

docs(evaluation): Understanding Evaluation concept
abhijaisrivastava15 and others added 16 commits July 9, 2026 19:39
- drop About heading and --- dividers, open at a real first H2
- bold error localization on first mention, link judge model/eval template/Observe
- drop the fake configured-threshold framing; state the real pass/fail vs low-score trigger
- soften code-type/non-scorable rows to what's grounded, not the private ee engine's internals
- compress How to enable it to the checkbox + the real OR-of-two-flags inheritance
- call it the Error Localization checkbox, not the API field name
- reword Review/Where results appear to the confirmed surfaces (trace detail eval view, dataset row drawer, Playground run tests)
- fix stale link to guides/running-evaluations, cut the backward Understanding-evaluation link
- Next steps -> Keep exploring, as cards

TH-6675
Add the tool-use mental model (response -> Agent Evaluator -> connector -> verdict)
and remove the annotated screenshot, which is how-to material and belongs in the
Configure connectors guide, not the concept.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Cut the threshold-calibration section and the SDK feedback pointer,
rewrite few-shot injection platform-first with a run-time steering
diagram, add the feedback actions, complete the sources to all seven
values, and move to the concept shape (opens at the first H2, no
separators, Keep exploring cards).

Signed-off-by: khushalsonawat <khushalsonawat@gmail.com>
docs(evaluation): Feedback (concept)
"Judge models" read as the LLM-as-Judge eval type (Rishav's feedback),
so the concept is now Evaluator model: page moved to
concepts/evaluator-models, term renamed across the evaluation tree,
FAQ, nav, and redirect targets; the LLM-as-Judge type name stays.

Also addresses review on the page: stale guides/ links repointed,
modality line made consistent with the table, first mention bolded,
backward card swapped for Guardrails, redundant How to choose section
dropped, and "Bring your own LLM" phrasing everywhere.

Signed-off-by: khushalsonawat <khushalsonawat@gmail.com>
docs(evaluation): Judge models concept
… to Guides

Add the two-jobs mental model (answer key + few-shot calibration),
switch to evaluator-model terminology, point the reference-based eval
mentions at the Built-in evals reference, state the upload formats,
and convert the footer to Keep exploring cards. Rename the Evaluation
nav section from How to guides to Guides, matching Observe.

Signed-off-by: khushalsonawat <khushalsonawat@gmail.com>
docs(evaluation): Ground truth (concept)
Add the templates-and-configs mental model (template as the image,
config as a running instance, an "Eval" colloquially meaning a config),
repoint judge-models to evaluator-models, fold the grounding clause in
place of the dropped Context page, correct the built-in count to 156,
and fix a nonexistent card icon.

Signed-off-by: khushalsonawat <khushalsonawat@gmail.com>
@khushalsonawat khushalsonawat marked this pull request as draft July 10, 2026 08:30
@khushalsonawat khushalsonawat closed this pull request by merging all changes into dev in bdfde71 Jul 10, 2026
@khushalsonawat khushalsonawat deleted the docs/evaluation-revamp branch July 10, 2026 13:37
@khushalsonawat khushalsonawat restored the docs/evaluation-revamp branch July 10, 2026 15:27
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