Skip to content

[docs] Improve XML docs for ObjCException, NLLanguage, CFHTTPAuthentication, CFHTTPStream, EKParticipantType, EKErrorCode, EKWeekday - #25976

Merged
rolfbjarne merged 8 commits into
mainfrom
dev/rolf/xmldocs-020-batch
Jul 10, 2026
Merged

[docs] Improve XML docs for ObjCException, NLLanguage, CFHTTPAuthentication, CFHTTPStream, EKParticipantType, EKErrorCode, EKWeekday#25976
rolfbjarne merged 8 commits into
mainfrom
dev/rolf/xmldocs-020-batch

Conversation

@rolfbjarne

Copy link
Copy Markdown
Member

Improve XML documentation for several types:

  • ObjCException: Add meaningful summaries and parameter docs
  • NLLanguage: Fix summary grammar
  • CFHTTPAuthentication: Remove empty <remarks> node
  • CFHTTPStream: Remove empty <remarks> node
  • EKParticipantType: Fix misleading summary
  • EKErrorCode: Improve enum member descriptions
  • EKWeekday: Improve enum member descriptions

Total: 46 changed lines (27 insertions, 19 deletions)

🤖 Pull request created by Copilot

rolfbjarne and others added 7 commits July 8, 2026 19:08
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 8, 2026 17:08
@rolfbjarne
rolfbjarne requested a review from dalexsoto as a code owner July 8, 2026 17:08

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.

Pull request overview

Improves XML documentation across several Apple platform bindings to make public API docs more accurate and helpful for consumers.

Changes:

  • Updated/expanded XML docs for ObjCException, NLLanguage, and multiple EventKit enums to replace placeholder text with meaningful descriptions.
  • Removed empty <remarks> blocks from CFHTTPAuthentication and CFHTTPStream.
  • Improved enum member summaries for EKErrorCode and EKWeekday.

Reviewed changes

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

Show a summary per file
File Description
src/NaturalLanguage/Enums.cs Updates NLLanguage.Unevaluated summary text.
src/Foundation/ObjCException.cs Replaces placeholder XML docs with more descriptive summaries/param docs.
src/EventKit/EKEnums.cs Improves enum member summaries for EKParticipantType, EKErrorCode, and EKWeekday.
src/CFNetwork/CFHTTPStream.cs Removes empty XML <remarks> node.
src/CFNetwork/CFHTTPAuthentication.cs Removes empty XML <remarks> node.

Comment thread src/NaturalLanguage/Enums.cs
Comment thread src/Foundation/ObjCException.cs
@vs-mobiletools-engineering-service2

This comment has been minimized.

dalexsoto
dalexsoto previously approved these changes Jul 8, 2026
@rolfbjarne
rolfbjarne enabled auto-merge (squash) July 8, 2026 18:35
@vs-mobiletools-engineering-service2

This comment has been minimized.

@vs-mobiletools-engineering-service2

This comment has been minimized.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@vs-mobiletools-engineering-service2

This comment has been minimized.

@vs-mobiletools-engineering-service2

Copy link
Copy Markdown
Collaborator

✅ API diff for current PR / commit

NET (empty diffs)

✅ API diff vs stable

NET (empty diffs)

ℹ️ Generator diff

Generator Diff: vsdrops (html) vsdrops (raw diff) gist (raw diff) - Please review changes)

Pipeline on Agent
Hash: 365088b1868566f4575c7a7e3a5483938eccf1b6 [PR build]

@vs-mobiletools-engineering-service2

Copy link
Copy Markdown
Collaborator

🚀 [CI Build #365088b] Test results 🚀

Test results

✅ All tests passed on VSTS: test results.

🎉 All 199 tests passed 🎉

Tests counts

✅ assembly-processing: All 1 tests passed. Html Report (VSDrops) Download
✅ cecil: All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (iOS): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (MacCatalyst): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (macOS): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (Multiple platforms): All 1 tests passed. Html Report (VSDrops) Download
✅ dotnettests (tvOS): All 1 tests passed. Html Report (VSDrops) Download
✅ framework: All 2 tests passed. Html Report (VSDrops) Download
✅ fsharp: All 4 tests passed. Html Report (VSDrops) Download
✅ generator: All 5 tests passed. Html Report (VSDrops) Download
✅ interdependent-binding-projects: All 4 tests passed. Html Report (VSDrops) Download
✅ introspection: All 4 tests passed. Html Report (VSDrops) Download
✅ linker (iOS): All 15 tests passed. Html Report (VSDrops) Download
✅ linker (MacCatalyst): All 15 tests passed. Html Report (VSDrops) Download
✅ linker (macOS): All 21 tests passed. Html Report (VSDrops) Download
✅ linker (tvOS): All 15 tests passed. Html Report (VSDrops) Download
✅ monotouch (iOS): All 18 tests passed. Html Report (VSDrops) Download
✅ monotouch (MacCatalyst): All 17 tests passed. Html Report (VSDrops) Download
✅ monotouch (macOS): All 18 tests passed. Html Report (VSDrops) Download
✅ monotouch (tvOS): All 18 tests passed. Html Report (VSDrops) Download
✅ msbuild: All 2 tests passed. Html Report (VSDrops) Download
✅ sharpie: All 1 tests passed. Html Report (VSDrops) Download
✅ windows: All 3 tests passed. Html Report (VSDrops) Download
✅ xcframework: All 4 tests passed. Html Report (VSDrops) Download
✅ xtro: All 1 tests passed. Html Report (VSDrops) Download

macOS tests

✅ Tests on macOS Monterey (12): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Ventura (13): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Sonoma (14): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Sequoia (15): All 5 tests passed. Html Report (VSDrops) Download
✅ Tests on macOS Tahoe (26): All 5 tests passed. Html Report (VSDrops) Download

Linux Build Verification

Linux build succeeded

Pipeline on Agent
Hash: 365088b1868566f4575c7a7e3a5483938eccf1b6 [PR build]

@rolfbjarne
rolfbjarne merged commit 9b3e9a8 into main Jul 10, 2026
62 checks passed
@rolfbjarne
rolfbjarne deleted the dev/rolf/xmldocs-020-batch branch July 10, 2026 06:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants