Skip to content

Prefer repository terminology in generated output - #85878

Merged
mwiemer-microsoft merged 4 commits into
mainfrom
mwiemer-repository-instructions-terminology
Oct 1, 2026
Merged

mwiemer-microsoft merged 4 commits into
mainfrom
mwiemer-repository-instructions-terminology

Conversation

@mwiemer-microsoft

@mwiemer-microsoft mwiemer-microsoft commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

AI is currently using ambiguous terms like "worker" and "router" instead of repo-specific terms. Hopefully this helps :)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@azure-pipelines

This comment has been minimized.

@mwiemer-microsoft mwiemer-microsoft changed the title Add repository terminology guidance Add repository terminology guidance to AI code style section Oct 1, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@mwiemer-microsoft mwiemer-microsoft changed the title Add repository terminology guidance to AI code style section Scope repository terminology guidance to user-facing prose Oct 1, 2026
@mwiemer-microsoft mwiemer-microsoft changed the title Scope repository terminology guidance to user-facing prose Prefer repository terminology in generated output Oct 1, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Comment thread .github/copilot-instructions.md Resolved
@mwiemer-microsoft
mwiemer-microsoft marked this pull request as ready for review October 1, 2026 20:41
@mwiemer-microsoft
mwiemer-microsoft requested a review from a team as a code owner October 1, 2026 20:41
Copilot AI balanced review requested due to automatic review settings October 1, 2026 20:41
@mwiemer-microsoft
mwiemer-microsoft enabled auto-merge (squash) October 1, 2026 20:41
@mwiemer-microsoft
mwiemer-microsoft merged commit 7c238e7 into main Oct 1, 2026
4 of 6 checks passed
@dotnet-policy-service dotnet-policy-service Bot added this to the Next milestone Oct 1, 2026

Copilot AI 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.

Copilot review overview

🟡 Changes recommended

The instruction does not reliably prevent the ambiguity described by the PR.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Adds repository-specific terminology guidance for AI-generated output.

Changes:

  • Adds a repo-wide terminology preference.
  • One discrepancy identified: wording still permits “worker” and “router.”
File Description
.github/​copilot-instructions.md Adds terminology guidance.


> This is the **canonical** repo-wide agent entry point. `AGENTS.md` at the repo root points here. Path-scoped rules in `.github/instructions/{Compiler,IDE,Razor}.instructions.md` apply automatically by area and supplement this file. This file establishes the memory-first orientation protocol and doc-maintenance obligation.
>
> Across AI-generated output (code, documentation, and user-facing prose), prefer terminology already used in this repository.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

the Language Server telemetry router

This was the motivating example to get rid of it. 😄

333fred added a commit that referenced this pull request Oct 2, 2026
# By Sam Harwell (331) and others
# Via GitHub (414) and others
* upstream/main: (1352 commits)
  Document known issue workarounds inline (#85896)
  Restore automatic HTML test results for local runs (#85892)
  Report actual errors when strong-name HRESULT assertions fail (#85894)
  Restore main insertions after the VS 18.12 snap (#85824)
  Add "edit criteria" for AI doc updates (#85893)
  Handle cref type parameters in symbol lookup (#85840)
  Fix build warnings (#85754)
  Improve our Copilot instructions for testing
  [main] Update dependencies from dotnet/arcade (#85885)
  Rewrite 'router' phrasing
  Address review feedback
  Add option to disable cref paste fix
  Prefer repository terminology in generated output (#85878)
  Use cref for workspace extension handler
  Remove unnecessary static diagnostic registration
  Unsafe evolution: use safety documentation for unnecessary unsafe (#85842)
  Add Razor compiler team to code owners
  Unsafe evolution: avoid constructor recursion (#85773)
  Add roslyn-ide to Razor code owners
  Fix unexpected System.ArrayTypeMismatchException for captured method call receivers (#85811)
  ...

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: fd482dbd-c828-466b-87c6-6b2103be2089

# Conflicts:
#	src/Compilers/CSharp/Portable/Errors/ErrorCode.cs
#	src/Compilers/CSharp/Portable/Errors/MessageID.cs
@akhera99 akhera99 modified the milestones: Next, 18.13 Oct 26, 2026
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.

4 participants