Skip to content

Add docs for NETSDK1237 diagnostic#52994

Merged
gewarren merged 3 commits intomainfrom
copilot/add-diagnostic-code-docs
Apr 15, 2026
Merged

Add docs for NETSDK1237 diagnostic#52994
gewarren merged 3 commits intomainfrom
copilot/add-diagnostic-code-docs

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 13, 2026

Adds documentation for NETSDK1237, a new SDK warning introduced in dotnet/sdk#53635.

What is NETSDK1237?

The warning fires when an assembly is listed in PublishReadyToRunPartialAssemblies but is also being compiled into a ReadyToRun composite image (PublishReadyToRunComposite=true). These two settings are incompatible — partial compilation only works for assemblies compiled separately, not ones compiled into a composite image.

Changes

  • New article: docs/core/tools/sdk-errors/netsdk1237.md — describes the warning, its cause, and two ways to resolve it
  • Updated docs/core/tools/sdk-errors/index.md — added a linked table row for NETSDK1237
  • Updated docs/navigate/tools-diagnostics/toc.yml — added NETSDK1237 to the navigation

Content source

  • Diagnostic message text: copied verbatim from the SDK PR's Strings.resx
  • Article body: AI-generated based on the diagnostic message and PR description

Internal previews

📄 File 🔗 Preview link
docs/core/tools/sdk-errors/index.md .NET SDK error list
docs/core/tools/sdk-errors/netsdk1237.md "NETSDK1237: Assembly listed in PublishReadyToRunPartialAssemblies but compiled into a composite image"
docs/navigate/tools-diagnostics/toc.yml docs/navigate/tools-diagnostics/toc

Copilot AI and others added 2 commits April 13, 2026 19:08
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/4f8fd133-0e75-4727-9793-9d6773e18749

Co-authored-by: jkoritzinsky <1571408+jkoritzinsky@users.noreply.github.com>
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/4f8fd133-0e75-4727-9793-9d6773e18749

Co-authored-by: jkoritzinsky <1571408+jkoritzinsky@users.noreply.github.com>
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

Adds a new documentation page for the .NET SDK warning NETSDK1237 and wires it into the existing SDK errors index and navigation so it’s discoverable alongside other NETSDK diagnostics.

Changes:

  • Added a new NETSDK1237 diagnostic article describing the cause and resolution options.
  • Added NETSDK1237 to the SDK errors index table.
  • Added NETSDK1237 to the Tools and diagnostics TOC under NETSDK errors.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/navigate/tools-diagnostics/toc.yml Adds NETSDK1237 to the navigation under NETSDK errors.
docs/core/tools/sdk-errors/netsdk1237.md New diagnostic article documenting what triggers NETSDK1237 and how to resolve it.
docs/core/tools/sdk-errors/index.md Adds a linked index entry for NETSDK1237 with the diagnostic message text.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@gewarren gewarren merged commit ee6f626 into main Apr 15, 2026
11 checks passed
@gewarren gewarren deleted the copilot/add-diagnostic-code-docs branch April 15, 2026 00:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants