Skip to content

Move LLM evaluation docs to Investigate - #39522

Open
FouadWahabi wants to merge 3 commits into
masterfrom
dd/fouad/llm-evals-investigate
Open

Move LLM evaluation docs to Investigate#39522
FouadWahabi wants to merge 3 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

Copy link
Copy Markdown
Contributor

View session in Datadog

Bits Code status: ✅ Done

CI Auto-fix: Disabled | Enable

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.

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.

4 participants