Skip to content

docs(evaluation): Ground truth (concept)#723

Merged
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-ground-truth
Jul 10, 2026
Merged

docs(evaluation): Ground truth (concept)#723
khushalsonawat merged 3 commits into
docs/evaluation-revampfrom
docs/eval-ground-truth

Conversation

@abhijaisrivastava15

Copy link
Copy Markdown
Contributor

Summary

New Evaluation concept page: Ground truth — reference values that reference-based evals compare model outputs against.

Covers when to use ground truth, which templates consume it, how the data is structured, variable/role mapping, and few-shot grounding via embeddings.

Grounding (verified against the product repo)

  • Ground truth stored as JSON rows; embedding status + async re-embed on mapping change — model_hub/models/evals_metric.py, model_hub/services/ground_truth_service.py
  • Templates that use it exist: ground_truth_match, answer_similarity, fuzzy_match, recall_at_k, mean_average_precisionmodel_hub/system_evals/
  • Dropped unverifiable claims (file-format list, auto-detect) rather than guessing

Checks

  • Renders 200 on astro dev
  • Internal links resolve on docs/evaluation-revamp; title matches the sidebar label
  • No em-dashes, no marketing adjectives; sibling shape (About / Next steps)

TH-6675

… 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>
@khushalsonawat khushalsonawat merged commit cfdb648 into docs/evaluation-revamp Jul 10, 2026
@khushalsonawat khushalsonawat deleted the docs/eval-ground-truth branch July 10, 2026 08:06
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