Skip to content

[API 37] Update Android API documentation - #643

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

[API 37] Update Android API documentation#643
jonathanpeppers wants to merge 5 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 and others added 3 commits August 18, 2026 08:41
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>
Resolve API 37 generation conflicts against current main and restore substantive documentation where generated placeholders would replace authored text.

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>
@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 and others added 2 commits August 18, 2026 15:30
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
@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.

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