KEMBAR78
Add CornerRadius parameter order notes by jfversluis · Pull Request #30930 · dotnet/maui · GitHub
Skip to content

Conversation

jfversluis
Copy link
Member

This PR adds notes to properties with the CornerRadius type. The order of declaring the parameter values is a bit out of line with other frameworks. That is hard to fix (not from a technical standpoint, but from a breaking change perspective) so this is our "fix" for now. Also see: #13136 (comment)

Additionally, minor code improvements: move XML into source, file-scope namespace, etc.

Fixes #13136

@jfversluis jfversluis added the area-docs Conceptual docs, API docs, Samples label Jul 30, 2025
@Copilot Copilot AI review requested due to automatic review settings July 30, 2025 14:11
@jfversluis jfversluis requested a review from a team as a code owner July 30, 2025 14:11
Copy link
Contributor

@Copilot 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

This PR adds important clarification notes to properties that use the CornerRadius type, addressing a documentation gap where the parameter order differs from other frameworks. The main goal is to inform developers that corner radius values should be specified in the order: top left, top right, bottom left, and bottom right.

Key changes include:

  • Addition of parameter order notes to all CornerRadius properties across multiple UI components
  • Migration of XML documentation from external files to inline source code comments
  • Modernization of code structure with file-scoped namespaces

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/Controls/src/Core/Shapes/RoundRectangleGeometry.cs Replaced XML includes with inline documentation and added corner radius parameter order notes
src/Controls/src/Core/Shapes/RoundRectangle.cs Added inline documentation with corner radius parameter order clarification
src/Controls/src/Core/ICornerElement.cs Converted to file-scoped namespace and added comprehensive interface documentation with parameter order notes
src/Controls/src/Core/BoxView/BoxView.cs Replaced XML includes with inline documentation and added corner radius parameter order notes
src/Controls/docs/Microsoft.Maui.Controls/BoxView.xml Removed external XML documentation file (content moved to source)
src/Controls/docs/Microsoft.Maui.Controls.Shapes/RoundRectangleGeometry.xml Removed external XML documentation file (content moved to source)

@PureWeen
Copy link
Member

PureWeen commented Aug 2, 2025

  • failing tests unrelated

@PureWeen PureWeen merged commit 6c98e8b into main Aug 2, 2025
125 of 129 checks passed
@PureWeen PureWeen deleted the corner-radius-docs branch August 2, 2025 22:03
SuthiYuvaraj pushed a commit to SuthiYuvaraj/maui that referenced this pull request Aug 12, 2025
@github-actions github-actions bot locked and limited conversation to collaborators Sep 2, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area-docs Conceptual docs, API docs, Samples t/housekeeping ♻︎

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CornerRadius works incorrectly due to wrong parameter order

2 participants