Skip to content

Document Android text classifier APIs - #438

Open
jonathanpeppers wants to merge 2 commits into
mainfrom
jonathanpeppers-document-text-classifiers
Open

Document Android text classifier APIs#438
jonathanpeppers wants to merge 2 commits into
mainfrom
jonathanpeppers-document-text-classifiers

Conversation

@jonathanpeppers

@jonathanpeppers jonathanpeppers commented Aug 14, 2026

Copy link
Copy Markdown
Member

Refs #227

Sources

Validation

  • python - inline XML/CRLF/source-anchor validation: passed for 71 changed XML files and 399 official reference links and anchors.
  • git diff --check origin/main: passed.
  • git diff --name-only origin/main -- docs/xml/index.xml: no output; the index is unchanged.
  • 580 placeholders remain for projections without authoritative Android or public AOSP prose; this PR intentionally leaves Add XML documentation for Android.Views.TextClassifiers #227 open.

Refs #227

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

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.

Pull request overview

This PR updates the generated XML documentation for the Android.Views.TextClassifiers surface area to replace “To be added.” placeholders with prose derived from the Android Developers API reference, and to add consistent reference links/attribution.

Changes:

  • Replaced placeholder summaries/remarks across many Android.Views.TextClassifiers XML docs with API descriptions and nullability/value notes.
  • Standardized outbound links to Android reference pages and consolidated attribution/licensing text in remarks.
  • Expanded enum/constant/member documentation for selection, linkify, language detection, and conversation actions APIs.

Reviewed changes

Copilot reviewed 69 out of 71 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
docs/xml/Android.Views.TextClassifiers/TextSelection+Request+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextSelection+Request+Builder.xml Adds builder/member docs and Android reference links (some method docs need correction).
docs/xml/Android.Views.TextClassifiers/TextSelection+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLinks+TextLinkSpan.xml Consolidates remarks and updates reference link phrasing.
docs/xml/Android.Views.TextClassifiers/TextLinks+TextLink+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLinks+Request+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLinks+Request+Builder.xml Adds builder/member docs and Android reference links (some method docs need correction).
docs/xml/Android.Views.TextClassifiers/TextLinks+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLanguage+Request+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLanguage+Request+Builder.xml Adds builder/member docs and Android reference links (some param type text needs correction).
docs/xml/Android.Views.TextClassifiers/TextLanguage+Request.xml Updates type/member docs, adds nullability/value notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextLanguage+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextLanguage+Builder.xml Updates builder/member docs, adds nullability/value notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEventCategory.xml Documents enum values with descriptions and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+TextSelectionEvent+Builder.xml Documents builder APIs and adds Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+TextLinkifyEvent+Builder.xml Documents builder APIs and adds Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+TextLinkifyEvent.xml Updates event type docs and CREATOR documentation (some summary text needs correction).
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+LanguageDetectionEvent+Builder.xml Documents builder APIs and adds Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+LanguageDetectionEvent.xml Updates event type docs and CREATOR documentation (some remarks/summary text needs correction).
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+ConversationActionsEvent+Builder.xml Documents builder APIs and adds Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+ConversationActionsEvent.xml Updates event type docs and CREATOR documentation (some summary text needs correction).
docs/xml/Android.Views.TextClassifiers/TextClassifierEntityConfig+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextClassifierEntityConfig+Builder.xml Adds builder/member docs and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassificationSessionId+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextClassificationSessionId.xml Updates type/member docs, adds nullability/value notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassificationManager.xml Updates manager API docs and Android reference links (property getter/setter docs need alignment).
docs/xml/Android.Views.TextClassifiers/TextClassificationContext+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextClassificationContext+Builder.xml Updates builder docs with nullability/value notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassificationContext.xml Updates type/member docs, adds nullability/value notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/TextClassification+Request+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/TextClassification+Request+Builder.xml Adds builder/member docs and Android reference links (some method docs need correction).
docs/xml/Android.Views.TextClassifiers/TextClassification+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/SelectionInvocationMethod.xml Documents enum values with descriptions and Android reference links.
docs/xml/Android.Views.TextClassifiers/SelectionEventType.xml Documents enum values with descriptions and Android reference links.
docs/xml/Android.Views.TextClassifiers/SelectionEvent+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/SelectionAction.xml Documents enum values with descriptions and Android reference links.
docs/xml/Android.Views.TextClassifiers/ITextClassifierExtensions.xml Adjusts docs block placement/formatting for extension methods.
docs/xml/Android.Views.TextClassifiers/ITextClassificationSessionFactory.xml Updates interface method docs with nullability notes and Android reference links.
docs/xml/Android.Views.TextClassifiers/ConversationActions+Request+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/ConversationActions+Request+Builder.xml Adds builder/member docs and Android reference links.
docs/xml/Android.Views.TextClassifiers/ConversationActions+Message+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/ConversationActions+Message+Builder.xml Adds builder/member docs and Android reference links.
docs/xml/Android.Views.TextClassifiers/ConversationActions+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/ConversationAction+InterfaceConsts.xml Refines Parcelable/flag constant documentation and reference links.
docs/xml/Android.Views.TextClassifiers/ConversationAction+Builder.xml Updates builder/member docs and Android reference links (minor wording correction needed).
docs/xml/Android.Views.TextClassifiers/ApplyStrategy.xml Documents enum values with descriptions and Android reference links.
docs/xml/Android.Views.TextClassifiers/ApplyStatusCode.xml Documents enum values with descriptions and Android reference links.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/xml/Android.Views.TextClassifiers/TextSelection+Request+Builder.xml Outdated
Comment thread docs/xml/Android.Views.TextClassifiers/TextLinks+Request+Builder.xml Outdated
Comment thread docs/xml/Android.Views.TextClassifiers/TextClassification+Request+Builder.xml Outdated
Comment thread docs/xml/Android.Views.TextClassifiers/TextClassifierEvent+TextLinkifyEvent.xml Outdated
Comment thread docs/xml/Android.Views.TextClassifiers/ConversationAction+Builder.xml Outdated
Comment thread docs/xml/Android.Views.TextClassifiers/TextClassificationManager.xml Outdated
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@jonathanpeppers
jonathanpeppers requested review from dalexsoto and removed request for dalexsoto August 14, 2026 11:06
@jonathanpeppers
jonathanpeppers enabled auto-merge (squash) August 14, 2026 11:06
@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

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.

2 participants