Skip to content

Move LLM evaluation docs to Investigate - #39522

Merged
FouadWahabi merged 5 commits into
masterfrom
dd/fouad/llm-evals-investigate
Sep 1, 2026
Merged

Move LLM evaluation docs to Investigate#39522
FouadWahabi merged 5 commits into
masterfrom
dd/fouad/llm-evals-investigate

Conversation

@FouadWahabi

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Motivation: Agent Observability evaluation docs should be discoverable from Investigate, where users look for evaluation results while troubleshooting LLM applications. The Evaluation Developer Guide also needed a visible navigation entry after the evaluations section moved.

Changes:

  • Moved the English evaluation docs from hugo/content/en/llm_observability/configure/evaluations to hugo/content/en/llm_observability/investigate/evaluations.
  • Reparented Evaluations under Investigate in hugo/config/_default/menus/main.en.yaml and added Evaluation Developer Guide to the Evaluations nav group.
  • Updated English LLM Observability links to the new /llm_observability/investigate/evaluations paths.
  • Added aliases for the former /llm_observability/configure/evaluations URLs so existing links continue to redirect.
  • Removed Evaluations from the Configure landing page.

Testing:

  • Parsed hugo/config/_default/menus/main.en.yaml with Ruby YAML.
  • Parsed front matter for hugo/content/en/llm_observability/**/*.md with Ruby YAML.
  • Ran a local route check for /llm_observability/investigate/evaluations links against English content files and aliases.
  • Attempted /usr/local/hugo/bin/hugo -s hugo -d /tmp/dd-docs-public --environment development --logLevel info, but the build could not download github.com/DataDog/websites-modules from the sandbox proxy.

Merge readiness

  • Ready for merge

For Datadog employees:

AI assistance

Used Bits Code powered by Codex CLI to update the docs IA, links, aliases, and navigation, then run local validation.

Additional notes

The full Hugo build should be rerun in CI or an environment with access to the Hugo module dependencies.


PR by Bits - View session in Datadog

Comment @DataDog to request changes

Co-authored-by: FouadWahabi <7347238+FouadWahabi@users.noreply.github.com>
@datadog-datadog-prod-us1-2

datadog-datadog-prod-us1-2 Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

View session in Datadog

Bits Code status: ✅ Done

Comment @DataDog to request changes

@FouadWahabi
FouadWahabi requested a review from a team as a code owner August 27, 2026 16:22
@datadog-datadog-us1-prod

Copy link
Copy Markdown

I can only run on private repositories.

@github-actions github-actions Bot added Architecture Everything related to the Doc backend Guide Content impacting a guide labels Aug 27, 2026
@evazorro evazorro self-assigned this Aug 27, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Renamed files

Modified Files

@evazorro evazorro removed their assignment Aug 27, 2026
@melamos

melamos commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Preview links are 404ing, so I opened https://datadoghq.atlassian.net/browse/DOCS-15538 to investigate and do a more thorough review.

@melamos melamos added the editorial review Waiting on a more in-depth review label Aug 27, 2026
@gsvigruha

Copy link
Copy Markdown
Contributor

@melamos fixed on rerun

@datadog-datadog-prod-us1-2

This comment has been minimized.

@jeff-morgan-dd jeff-morgan-dd self-assigned this Sep 1, 2026

@jeff-morgan-dd jeff-morgan-dd 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.

Looks good! One note - /managed_evaluations/_index.html would be an L4 nav item and so could be added to the nav if you want, not sure if that omission from the menu was intentional (i know the L5 items were correctly omitted intentionally.)

Thanks for the PR!

@FouadWahabi
FouadWahabi merged commit f9bb802 into master Sep 1, 2026
24 checks passed
@FouadWahabi
FouadWahabi deleted the dd/fouad/llm-evals-investigate branch September 1, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend Bits AI editorial review Waiting on a more in-depth review Guide Content impacting a guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants