Improve Controls Core API docs

[jfversluis]

This pull request improves the inline documentation for several core UI controls in the codebase by replacing XML documentation includes with explicit XML doc comments. These changes enhance the clarity and accessibility of API documentation directly in the source files, making it easier for developers to understand the purpose and usage of properties, events, and methods without relying on external XML files.

The most important changes are grouped below by control:

CheckBox:

• Replaced <include> tags with detailed XML doc comments for the class, properties (such as IsChecked, Color), and events (like CheckedChanged), providing clear summaries and usage notes. [1] [2] [3]

Editor:

• Added explicit XML doc comments for bindable properties (CharacterSpacingProperty, AutoSize, HorizontalTextAlignment, VerticalTextAlignment) and the Completed event, clarifying their behavior and default values. [1] [2] [3]

ImageButton:

• Replaced <include> tags with comprehensive XML doc comments for the class, all bindable properties, events (Clicked, Pressed, Released), and internal methods, providing detailed descriptions, remarks, and default values. [1] [2]

RadioButton:

• Added explicit XML doc comments for the class and its constants, describing their purpose and usage in grouping and visual states.

These updates ensure that developers have immediate access to up-to-date documentation within the code, improving maintainability and developer experience.

[Copilot]

Pull request overview

This pull request removes XML documentation <include> references and replaces them with explicit inline XML documentation comments for several core UI controls (CheckBox, Editor, ImageButton, RadioButton, SearchBar, Slider, Stepper, and Switch). The corresponding external XML documentation files (Stepper.xml, Editor.xml, CheckBox.xml) are deleted as they are no longer needed.

Key Changes:

• Replaced <include file="..."> tags with complete <summary>, <remarks>, <value>, <param>, and <exception> XML documentation
• Added comprehensive documentation for classes, properties, events, constructors, and methods
• Deleted obsolete external XML documentation files

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
Switch.cs	Added inline XML docs for class, constants, properties, constructor, and Toggled event
Stepper.cs	Added inline XML docs for class, constructors, properties, and ValueChanged event
Slider.cs	Added inline XML docs for class, constructors, properties, and events
SearchBar.cs	Added inline XML docs for class, bindable properties, properties, event, constructor, and methods
RadioButton.cs	Added inline XML docs for class, constants, properties, constructor, and methods
ImageButton.cs	Added inline XML docs for class, properties, events, constructor, and internal methods
Editor.cs	Added inline XML docs for CharacterSpacingProperty, AutoSize, text alignment properties, and Completed event
CheckBox.cs	Added inline XML docs for class, IsCheckedVisualState constant, properties, constructor, and CheckedChanged event
Stepper.xml	Deleted - no longer needed
Editor.xml	Deleted - no longer needed
CheckBox.xml	Deleted - no longer needed

[PureWeen]

/rebase

[PureWeen]

/rebase

[PureWeen]

/azp run maui-pr-uitests

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).