| name | add-compiler-diagnostic-fix |
| description | Use when adding a Roslynator code fix for C# compiler error CS#### or RCF####, editing Diagnostics.xml or CodeFixes.xml, or when compiler-diagnostic-fixes-testing.md shows XunitCompilerDiagnosticFixVerifier or bare DiagnosticId like "CS0106" — in-repo uses AbstractCSharpCompilerDiagnosticFixVerifier and CompilerDiagnosticIdentifiers. Contributor how-to exists but testing page targets NuGet consumers. |
Add Compiler Diagnostic Fix
Overview
Compiler fixes use Diagnostics.xml + CodeFixes.xml → codegen → CompilerDiagnosticCodeFixProvider → test. Contributor how-to: how-to-add-compiler-diagnostic-fix. Do not follow compiler-diagnostic-fixes-testing alone — it targets NuGet consumers.
When to Use
- New fix for
CS#### compiler diagnostic
- New
RCF#### entry linking one or more CS ids
- Extending fix coverage for an existing compiler error
Not for: Roslynator analyzers (add-analyzer), refactorings (add-refactoring).
Gate: approved GitHub issue (CONTRIBUTING.md).
Read references/implementation.md before writing tests.
Confirm metadata parameters (hard gate)
STOP. Do NOT edit Diagnostics.xml / CodeFixes.xml, run codegen, or implement until the user has confirmed every required parameter below. Do not invent titles or identifiers when the user (or issue) did not state them.
Use AskQuestion when available; otherwise ask conversationally. Batch related choices.
| Parameter | Required? | Notes |
|---|
Compiler CS#### id(s) | yes | One RCF may fix multiple CS ids |
New Diagnostics.xml entry? | if CS not already cataloged | Confirm Title / Message / HelpUrl (usually from Microsoft docs) |
RCF Id | propose | Compute next free RCF#### from CodeFixes.xml, or extend an existing RCF when appropriate; do not ask unless ambiguous |
Identifier | yes | PascalCase for the code fix |
Title | yes | Code-fix menu / docs title |
| Code action title | yes | String passed to CodeAction.Create (may match or differ from XML Title) |
When proposing RCF Id, state the chosen value in your plan/summary (e.g. “using next free RCF0121”). Skip asking other parameters only when the approved issue or the user's message already states the value explicitly.
Quick Reference
| Step | Location |
|---|
| Diagnostic catalog | src/Diagnostics.xml |
| Fix metadata | src/CodeFixes.xml |
| Codegen | cd tools && pwsh ./generate_code.ps1 |
| Provider | src/CodeFixes/CSharp/CodeFixes/ |
| Tests | src/Tests/CodeFixes.Tests/CS####IdentifierTests.cs |
| Changelog | CHANGELOG.md |
Implementation
- Confirm metadata parameters (hard gate above).
- Full XML, provider, and test patterns: references/implementation.md.
Changelog:
- Add code fix "TITLE" for CS#### ([#PR](https://github.com/dotnet/roslynator/pull/PR))
Verify:
cd tools && pwsh ./generate_code.ps1
cd src && dotnet build Roslynator.sln
cd src && dotnet test Tests/CodeFixes.Tests --no-build --filter "FullyQualifiedName~CS####"
cd src && dotnet format Roslynator.sln --no-restore --verify-no-changes --severity info
Common Mistakes
| Mistake | Fix |
|---|
Guess RCF Title / Identifier / code-action string | Ask — hard gate above |
Follow compiler-diagnostic-fixes-testing.md | In-repo: AbstractCSharpCompilerDiagnosticFixVerifier |
DiagnosticId = "CS0106" literal | Use CompilerDiagnosticIdentifiers.CS####_Identifier constant |
| `[ | ... |
Skip IsEnabled in provider | Required for EditorConfig / global compiler-fix toggles |
| Only read testing doc | Also need Diagnostics.xml, CodeFixes.xml, codegen, provider base |
| Codegen from repo root | cd tools && pwsh ./generate_code.ps1 |
