Skip to content

Document Tensor shape alignment breaking change - #56336

Open
tannergooding wants to merge 4 commits into
dotnet:mainfrom
tannergooding:tannergooding-issue-56305
Open

tannergooding wants to merge 4 commits into
dotnet:mainfrom
tannergooding:tannergooding-issue-56305

Conversation

@tannergooding

@tannergooding tannergooding commented Oct 6, 2026 •

Copy link
Copy Markdown
Member

Summary

Add a .NET 11 breaking-change article for consistent Tensor shape alignment, default empty values, axis handling, and native-width traversal. Add the article to the .NET 11 compatibility index and navigation.

Fixes #56305

Content sources

The change description and affected API scope are adapted from dotnet/docs#56305 and the merged dotnet/runtime#135060. The compatibility explanation and migration guidance are newly written from those sources.

Validation

  • git show --check --format=oneline HEAD passed.
  • All 27 Tensor API cross-references resolved against the Tensor API XML in dotnet/dotnet-api-docs.
  • The article's relative category link and both navigation entries resolve.
  • Markdownlint wasn't run locally because Node.js, npm, and npx aren't installed. The PR workflow will run it.

Note

This pull request was drafted with assistance from GitHub Copilot.


Internal previews

File Preview link
docs/core/compatibility/11.md Learn preview
docs/core/compatibility/core-libraries/11/tensor-shape-alignment.md Learn preview
docs/core/compatibility/toc.yml Learn preview
docs/standard/tensor-shapes-and-storage.md Learn preview

Build report

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

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 article omits that updating the NuGet package can affect earlier target frameworks.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Adds .NET 11 compatibility documentation for tensor shape-alignment changes.

Changes:

  • Documents behavioral changes and migration guidance.
  • Adds the article to the compatibility index and navigation.
File Description
tensor-shape-alignment.md Adds the breaking-change article.
11.md Adds the compatibility index entry.
toc.yml Adds the navigation entry.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/core/compatibility/core-libraries/11/tensor-shape-alignment.md
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@tannergooding
tannergooding requested a review from a team as a code owner October 6, 2026 23:37
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Comment thread docs/core/compatibility/core-libraries/11/tensor-shape-alignment.md Outdated
Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
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.

[Breaking change]: Tensor operations align equivalent shapes and empty tensors

3 participants