Delete remaining external XML documentation files#33663
Merged
jfversluis merged 1 commit intomainfrom Jan 22, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR completes the migration from external XML documentation to inline XML doc comments by deleting the entire src/Controls/docs/ directory containing orphaned documentation files. This is part 6 of a documentation coverage improvement series. All <include> directives referencing these files were already removed in previous PRs, making these files no longer used by the build system.
Changes:
- Deleted 63 orphaned files from
src/Controls/docs/directory - Removed 6 XML documentation files across multiple namespaces
- Removed 57 legacy screenshot/diagram image files
Reviewed changes
Copilot reviewed 6 out of 63 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
src/Controls/docs/Microsoft.Maui.Controls/ |
Deleted 6 orphaned XML files and 57 legacy image files (screenshots, diagrams) |
src/Controls/docs/Microsoft.Maui.Controls.StyleSheets/StyleSheet.xml |
Deleted orphaned XML documentation for StyleSheet class |
src/Controls/docs/Microsoft.Maui.Controls.Xaml/*.xml |
Deleted 3 orphaned XML files (XmlLineInfo, XamlResourceIdAttribute, XamlParseException) |
src/Controls/docs/Microsoft.Maui.Controls.Xaml.Diagnostics/*.xml |
Deleted orphaned BindingBaseErrorEventArgs XML documentation |
- Delete the entire src/Controls/docs/ directory (63 files) - These XML files were orphaned after previous PRs migrated all references to inline docs - No code changes needed as all include directives were already removed Deleted directories: - src/Controls/docs/Microsoft.Maui.Controls/ - src/Controls/docs/Microsoft.Maui.Controls.StyleSheets/ - src/Controls/docs/Microsoft.Maui.Controls.Xaml/ - src/Controls/docs/Microsoft.Maui.Controls.Xaml.Diagnostics/ This completes the migration from external XML to inline API documentation. Part of API documentation coverage improvement initiative (PR 6).
b822604 to
803a808
Compare
simonrozsival
approved these changes
Jan 22, 2026
kubaflo
approved these changes
Jan 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!
Description
This PR deletes the remaining external XML documentation files that are no longer referenced after previous PRs migrated all API documentation to inline XML doc comments.
What was done:
src/Controls/docs/directory (63 files)<include>directives were already removed in previous PRsDeleted directories:
src/Controls/docs/Microsoft.Maui.Controls/(6 orphaned XML files + 57 legacy images)src/Controls/docs/Microsoft.Maui.Controls.StyleSheets/src/Controls/docs/Microsoft.Maui.Controls.Xaml/src/Controls/docs/Microsoft.Maui.Controls.Xaml.Diagnostics/This completes the migration from external XML to inline API documentation.
This is PR 6 of a series to achieve 100% API documentation coverage.
Testing