Document inspector API contracts

[jonathanpeppers]

Sources

• https://developer.android.com/reference/android/view/inspector/IntFlagMapping#add(int,%20int,%20java.lang.String)
• https://developer.android.com/reference/android/view/inspector/IntFlagMapping#get(int)
• https://developer.android.com/reference/android/view/inspector/WindowInspector#getGlobalWindowViews()

Validation

• Parsed the changed XML files successfully.
• Confirmed CRLF line endings with no lone LF bytes.
• Ran git diff --check.
• Confirmed 70 To be added. occurrences remain in docs/xml/Android.Views.Inspectors; they are unrelated binding-runtime members without Android reference documentation.

Refs #243

[Copilot]

Pull request overview

This PR refines XML documentation for Android.Views.Inspectors members to better match the Android reference contracts (notably nullability/emptiness guarantees) and to improve wording consistency.

Changes:

• Updated WindowInspector.GetGlobalWindowViews() docs to clarify it returns a non-null list.
• Updated IntFlagMapping.Add(...) and IntFlagMapping.Get(int) docs to align phrasing with the Android reference (including non-null / empty-set semantics).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
docs/xml/Android.Views.Inspectors/WindowInspector.xml	Tightens summary/value wording for GetGlobalWindowViews() to reflect the API contract (non-null list).
docs/xml/Android.Views.Inspectors/IntFlagMapping.xml	Improves parameter/return contract wording for Add/Get and updates summaries accordingly.

Suppressed comments (1)

docs/xml/Android.Views.Inspectors/IntFlagMapping.xml:157

• In the Get member docs, the first remarks paragraph uses imperative phrasing ("Get …") while the summary uses third-person present tense ("Gets …"). Also, the <returns> text currently reads like it returns the names themselves rather than a collection; rewording to explicitly describe a (non-null, possibly empty) set improves clarity and matches the Android reference wording.

        <summary>Gets a set of the names of enabled flags for a given property value.</summary>
        <returns>The non-null names of the enabled flags, or an empty set if no flags are enabled.</returns>
        <remarks>
          <para>Get a set of the names of enabled flags for a given property value.</para>

---

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

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The inspector contracts, managed signatures, API metadata, and generated documentation match Android.