Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added all missing xml docs for Tensors #106084

Merged
merged 5 commits into from
Aug 13, 2024

Conversation

michaelgsharp
Copy link
Member

This PR adds as missing XML docs for all public APIs.

It also enables UseCompilerGeneratedDocXmlFile so that we can use these as the source of truth. We will need to review the XML that was already in the repo and not being modified by this PR. That will be done in a separate PR so this is not held by that.

Copy link
Contributor

Tagging subscribers to this area: @dotnet/area-system-numerics-tensors
See info in area-owners.md if you want to be subscribed.

@michaelgsharp
Copy link
Member Author

@gewarren could you review the language for these new docs? We will also need to review the language for the other APIs not being added in this PR, but I'll do another pass on those before I have you take a look.

Copy link
Contributor

@gewarren gewarren left a comment

Choose a reason for hiding this comment

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

Thanks for tagging me!

src/libraries/System.Numerics.Tensors/src/System/NIndex.cs Outdated Show resolved Hide resolved
src/libraries/System.Numerics.Tensors/src/System/NIndex.cs Outdated Show resolved Hide resolved
src/libraries/System.Numerics.Tensors/src/System/NIndex.cs Outdated Show resolved Hide resolved
src/libraries/System.Numerics.Tensors/src/System/NIndex.cs Outdated Show resolved Hide resolved
src/libraries/System.Numerics.Tensors/src/System/NRange.cs Outdated Show resolved Hide resolved
/// <param name="shape1">The first shape to broadcast.</param>
/// <param name="shape2">The second shape to broadcast.</param>
/// <returns>The smallest lengths these shapes can be broadcast to.</returns>
/// <exception cref="ArgumentException"></exception>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// <exception cref="ArgumentException"></exception>
/// <exception cref="ArgumentException">The lengths of <paramref name="shape1" /> and <paramref name="shape2" /> are not broadcast compatible.</exception>

@ViktorHofer
Copy link
Member

@michaelgsharp I resolved your merge conflicts from #106179

@michaelgsharp
Copy link
Member Author

@gewarren all comments have been resolved.

@michaelgsharp michaelgsharp merged commit 9f8b9bf into dotnet:main Aug 13, 2024
82 of 84 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Sep 12, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants