[API 37] Update Android API documentation - #643
Conversation
118e7a2 to
bad8458
Compare
|
@dalexsoto review |
dalexsoto
left a comment
There was a problem hiding this comment.
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.
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
fce3462 to
dc31eb0
Compare
|
@dalexsoto Addressed in 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
left a comment
There was a problem hiding this comment.
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, andPrinterInfo.Builder.SetSetupIntent. - Preservation still drops 49 substantive base elements: 48 type-level summaries/remarks across 46 matched types plus the unchanged
ActivityManager.GetRecentTaskssummary. - Removing
IInputTypeleaves 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.
Summary
API level
This PR is specifically for Android API 37 (
AndroidApiLevel=37,AndroidPlatformId=37.0).Validation
Mono.Android.csprojviaUpdateExternalDocumentation