Skip to content

[API 37] Update Android API documentation - #643

Open
jonathanpeppers wants to merge 6 commits into
mainfrom
jonathanpeppers/api-37-docs
Open

[API 37] Update Android API documentation#643
jonathanpeppers wants to merge 6 commits into
mainfrom
jonathanpeppers/api-37-docs

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Member

Summary

  • regenerate the Android API reference from the current .NET for Android API 37 bindings
  • import documentation from the matching Android SDK API 37 sources
  • add 414 documentation files, update 7,713, and remove 2 obsolete files

API level

This PR is specifically for Android API 37 (AndroidApiLevel=37, AndroidPlatformId=37.0).

Validation

  • generated from Mono.Android.csproj via UpdateExternalDocumentation
  • no translation warnings, placeholder failures, or import failures

@jonathanpeppers
jonathanpeppers force-pushed the jonathanpeppers/api-37-docs branch from 118e7a2 to bad8458 Compare August 18, 2026 18:52
@jonathanpeppers
jonathanpeppers marked this pull request as ready for review August 18, 2026 18:52
@jonathanpeppers
jonathanpeppers requested review from dalexsoto and a lite review from Copilot August 18, 2026 18:52

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

@dalexsoto dalexsoto left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The API 37 regeneration drops authored documentation for at least 21 unchanged, signature-matched members across seven files, replacing real summaries/returns/remarks with To be added.. Confirmed examples include parcelable members in NetworkRegistrationInfo, PhysicalChannelConfig, and SubscriptionInfo; TelephonyManager request/radio-family members; six NetworkRegistrationInfoServiceType values; three PhoneNumberSource values; and AccessibleObject.IsAnnotationPresent. Please restore the main-branch prose and add a full signature-keyed preservation check so unchanged members cannot lose authored documentation.

jonathanpeppers and others added 5 commits August 20, 2026 10:48
Regenerate the Android API reference from the API 37 Mono.Android bindings and matching Android SDK sources.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Restore substantive documentation from main where API 37 generation introduced placeholder text after rebasing over the API 36.1 update.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
OpenPublishing requires unique ECMA member DocIds. Remove identical member
copies retained while resolving the API 36.1 and API 37 generated-doc
conflicts.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 57877110-585b-4e24-a34e-ec6cddc48db2
API 37 continues updating the existing .NET for Android Learn view. Reuse
the published net-android-36.0 moniker for the generated framework
inventory instead of referencing the undefined net-android-37.0 moniker.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 57877110-585b-4e24-a34e-ec6cddc48db2
Restore substantive documentation from main by exact or structural member
signature, including elements that were replaced with placeholders or removed.
Keep the API 37 member metadata while removing duplicate DocIds introduced by
the rebase.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 57877110-585b-4e24-a34e-ec6cddc48db2
@jonathanpeppers
jonathanpeppers force-pushed the jonathanpeppers/api-37-docs branch from fce3462 to dc31eb0 Compare August 20, 2026 16:02
@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto Addressed in dc31eb0f and rebased onto latest main (31260d9f).

The preservation pass now matches members by exact C# signature, falling back to member name/kind/ordered parameter types when generated return or enum projections change. It restores both placeholder replacements and documentation elements removed entirely. Final audit: 130,052 matched members, 0 substantive-to-placeholder regressions, and 0 missing substantive elements. I also resolved the rebase's 69 duplicate DocIds while retaining the pre-rebase API 37 member metadata; all 2,235 changed XML files parse, with 0 duplicate DocIds and 0 conflict markers.

Could you please re-review?

Update restored phone-number formatting documentation to use country/region
while retaining the ISO 3166-1 standards terminology unchanged.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 57877110-585b-4e24-a34e-ec6cddc48db2

@dalexsoto dalexsoto left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Three completeness blockers remain in the API 37 regeneration:

  • A full Android 37 source/signature audit finds 644 new API owners across 159 files still missing 1,179 source-documented elements (14 type descriptions, 623 member descriptions, 159 returns, and 383 parameters), including HealthPermissions.ReadActivityIntensity, String.SplitWithDelimiters, Notification.Metric.FixedTime, and PrinterInfo.Builder.SetSetupIntent.
  • Preservation still drops 49 substantive base elements: 48 type-level summaries/remarks across 46 matched types plus the unchanged ActivityManager.GetRecentTasks summary.
  • Removing IInputType leaves four exact-head broken xrefs, and OpenPublishing reports 27 deleted public destinations without redirects.

Please repair the API 37 source import, extend preservation to type-level docs and the missing member summary, update stale references, and add redirects/historical handling for every removed destination.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants