Skip to content

Freshness pass: Introduction to .NET#52136

Open
Copilot wants to merge 4 commits intomainfrom
copilot/update-dotnet-core-introduction
Open

Freshness pass: Introduction to .NET#52136
Copilot wants to merge 4 commits intomainfrom
copilot/update-dotnet-core-introduction

Conversation

Copy link
Contributor

Copilot AI commented Mar 10, 2026

Applies Microsoft Style Guide pass to docs/core/introduction.md — stale date, first-person "our", passive constructions, weak phrasing, and inconsistent dash usage.

Changes

  • Frontmatter: ms.date03/10/2026; added ai-usage: ai-assisted
  • Voice/passives: "runtime that is used in production" → "runtime used in production"; "due to using a GC" → "because it uses a GC"
  • Contractions: "It is type-safe" → "It's"; "It is updated monthly" → "It's"
  • First-person removed: "per our [releases and support policies]" → "per the …"
  • Weak constructions: "There are multiple variants … The reason … is part historical, part technical" → single sentence: "Multiple variants of .NET exist, each supporting a different type of app for both historical and technical reasons."
  • Word choice: "Additional licenses" → "Other"; "additional manual optimizations" → "more"; "being able to build, analyze, and test" → "building, analyzing, and testing"
  • Punctuation: All -- list separators (Components + .NET implementations) replaced with em-dashes

Contributes to #51732


Internal previews

📄 File 🔗 Preview link
docs/core/introduction.md Introduction to .NET

Copilot AI and others added 2 commits March 10, 2026 18:28
Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com>
@meaghanlewis meaghanlewis mentioned this pull request Mar 10, 2026
10 tasks
@meaghanlewis meaghanlewis marked this pull request as ready for review March 10, 2026 18:53
@meaghanlewis meaghanlewis requested a review from a team as a code owner March 10, 2026 18:53
Copilot AI review requested due to automatic review settings March 10, 2026 18:53
@meaghanlewis meaghanlewis changed the title Update introduction.md for style freshness and accuracy Freshness pass: Introduction to .NET Mar 10, 2026
Copy link
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

Applies a Microsoft Style Guide pass to refresh docs/core/introduction.md by updating metadata and improving clarity/voice consistency.

Changes:

  • Updated frontmatter metadata (including ms.date) and added ai-usage.
  • Refined wording to reduce passives/weak phrasing and removed first-person language.
  • Normalized punctuation by replacing -- with em dashes in lists.

You can also share your feedback on Copilot code review. Take the survey.

meaghanlewis and others added 2 commits March 10, 2026 12:09
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants