Skip to content

Analyzers: renumber to a single MP#### ID family, add HelpLinkUri, generate per-rule docs #3312

Description

@thomhurst

Category: analyzers / DX — Breaking: suppressions by old ID

  1. IDs are prose ("AsyncModule", "MissingDependsOnAttribute") for 7 rules while newer ones use MPDEP001/2/3 and dev analyzers use MPD0001/2. Prose IDs break dotnet_diagnostic.<id>.severity conventions and can't be prefix-matched.
  2. DiagnosticDescriptorFactory.cs:33-41 omits helpLinkUri — the IDE "learn more" link is dead for all 10 rules.
  3. docs/docs/how-to/analyzers.md lists 5 of 10 rules, has no IDs/severities/suppression guidance, untouched since 2024.

Fix: renumber to MP#### with AnalyzerReleases Removed/Renamed entries; helpLinkUri → generated per-rule docs pages sourced from AnalyzerReleases.*.md so the docs can't drift.

Part of #3239.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium: improvements and polish - after P1documentationImprovements or additions to documentationenhancementNew feature or requestin-progressPicked up by an agent

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions