Skip to content

AI freshness April: update evaluation and tokenizer docs#52961

Merged
gewarren merged 4 commits intomainfrom
copilot/update-ai-docs-for-freshness
Apr 10, 2026
Merged

AI freshness April: update evaluation and tokenizer docs#52961
gewarren merged 4 commits intomainfrom
copilot/update-ai-docs-for-freshness

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 9, 2026

Six stale .NET AI documentation articles refreshed for April with date updates, a tool install command fix, and Microsoft Style Guide improvements.

Key content fix

evaluate-with-reporting.md: The dotnet tool install --local command is replaced with --create-manifest-if-needed (available since .NET 8, auto-creates a manifest if none exists). The manual manifest TIP is removed since it's no longer necessary.

-dotnet tool install --local Microsoft.Extensions.AI.Evaluation.Console
+dotnet tool install --create-manifest-if-needed Microsoft.Extensions.AI.Evaluation.Console

Style improvements across all 6 files

  • ms.date updated to 04/09/2026 in all files
  • Passive voice → active voice throughout
  • Weak instruction language (you should, you can, you need to) → imperative mood
  • Causal sincebecause; additionalmore/another
  • Typo fixes (the the, with the all the data)
  • evaluate-safety.md retains --prereleaseMicrosoft.Extensions.AI.Evaluation.Safety is still preview-only

Files changed

  • docs/ai/evaluation/libraries.md
  • docs/ai/how-to/use-tokenizers.md
  • docs/ai/evaluation/evaluate-with-reporting.md
  • docs/ai/evaluation/evaluate-ai-response.md
  • docs/ai/evaluation/responsible-ai.md
  • docs/ai/evaluation/evaluate-safety.md

Internal previews

📄 File 🔗 Preview link
docs/ai/evaluation/evaluate-ai-response.md Quickstart: Evaluate response quality
docs/ai/evaluation/evaluate-safety.md Tutorial: Evaluate response safety with caching and reporting
docs/ai/evaluation/evaluate-with-reporting.md Tutorial - Evaluate response quality with caching and reporting
docs/ai/evaluation/libraries.md The Microsoft.Extensions.AI.Evaluation libraries
docs/ai/evaluation/responsible-ai.md docs/ai/evaluation/responsible-ai
docs/ai/how-to/use-tokenizers.md Use Microsoft.ML.Tokenizers for text tokenization

Copilot AI linked an issue Apr 9, 2026 that may be closed by this pull request
6 tasks
@dotnet-policy-service dotnet-policy-service bot added the okr-freshness OKR: Freshness of content label Apr 9, 2026
Copilot AI changed the title [WIP] Update AI documentation for freshness in April AI freshness April: update evaluation and tokenizer docs Apr 9, 2026
Copilot AI requested a review from gewarren April 9, 2026 17:06
@gewarren gewarren marked this pull request as ready for review April 9, 2026 17:51
@gewarren gewarren requested a review from a team as a code owner April 9, 2026 17:51
Copilot AI review requested due to automatic review settings April 9, 2026 17:51
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Refreshes six .NET AI documentation articles for April by updating dates, improving instructional style, and correcting guidance for installing the evaluation console tool.

Changes:

  • Updated ms.date to 04/09/2026 across the refreshed articles.
  • Revised wording to favor active voice and clearer, more direct instructions.
  • Updated the dotnet tool install command in the reporting tutorial to use --create-manifest-if-needed and removed the now-unnecessary manifest tip.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
docs/ai/evaluation/libraries.md Refresh date and tighten wording in evaluation library overview.
docs/ai/how-to/use-tokenizers.md Refresh date and improve clarity/voice in tokenizer how-to.
docs/ai/evaluation/evaluate-with-reporting.md Refresh date, improve tutorial phrasing, and update local tool install guidance.
docs/ai/evaluation/evaluate-ai-response.md Refresh date and minor wording updates in quickstart.
docs/ai/evaluation/responsible-ai.md Refresh date and simplify intro/description phrasing.
docs/ai/evaluation/evaluate-safety.md Refresh date and improve clarity in safety evaluation tutorial.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@gewarren gewarren enabled auto-merge (squash) April 9, 2026 19:22
Copy link
Copy Markdown
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM. Let's :shipit:

@gewarren gewarren merged commit 7542bf6 into main Apr 10, 2026
11 checks passed
@gewarren gewarren deleted the copilot/update-ai-docs-for-freshness branch April 10, 2026 14:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

okr-freshness OKR: Freshness of content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

AI freshness April

4 participants