Document Java reflection annotation APIs

[jonathanpeppers]

Summary

Documents the AnnotatedElement annotation-querying APIs implemented by Java.Lang.Reflect.Parameter and Java.Lang.Reflect.AccessibleObject.

Refs #197

Sources

• https://developer.android.com/reference/java/lang/reflect/Parameter
• https://developer.android.com/reference/java/lang/reflect/AccessibleObject
• https://developer.android.com/reference/java/lang/reflect/AnnotatedElement

Validation

• Parsed both edited XML files with PowerShell's XML parser.
• Confirmed CRLF line endings and git diff --check.
• Confirmed all seven documented annotation-querying members in each type have no To be added placeholders; scoped placeholder count changed from 193 to 156.

[Copilot]

Pull request overview

This PR improves the quality of the generated API reference documentation for Java.Lang.Reflect by replacing placeholder XML documentation with real descriptions for the AnnotatedElement-style annotation querying APIs on Java.Lang.Reflect.Parameter and Java.Lang.Reflect.AccessibleObject.

Changes:

• Replaced To be added placeholders with real <summary>, <returns>, and <param> docs for annotation-querying members on Parameter.
• Replaced To be added / incorrect placeholder summaries with real <summary>, <returns>, and <param> docs for annotation-querying members on AccessibleObject.
• Added/expanded remarks where helpful (including the annotation presence equivalence note), while keeping the Android reference links and required attribution paragraphs.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
docs/xml/Java.Lang.Reflect/Parameter.xml	Documents Parameter’s annotation querying APIs by replacing placeholder param/summary/returns and improving remarks.
docs/xml/Java.Lang.Reflect/AccessibleObject.xml	Documents AccessibleObject’s annotation querying APIs by replacing placeholder param/summary/returns and clarifying IsAnnotationPresent.

---

💡 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 new Parameter#isAnnotationPresent reference points to a nonexistent anchor because the inherited detail lives on AnnotatedElement. Please link to java/lang/reflect/AnnotatedElement#isAnnotationPresent(...) and update the displayed type name: Parameter.xml.

[jonathanpeppers]

@dalexsoto Addressed in f4ced12: the Parameter.IsAnnotationPresent reference now links to and displays java.lang.reflect.AnnotatedElement.isAnnotationPresent(...), where Android publishes the inherited method detail.

[dalexsoto]

The inherited annotation link is fixed, but all newly added <em> elements render as literal XML because ECMA2Yaml supports <i> but has no <em> transform. Please replace the 22 added <em> elements with <i> or plain text and verify the generated pages.

[jonathanpeppers]

Fixed in 3f9d742: replaced all 22 newly added <em> elements with ECMA2Yaml-supported <i> elements. Both XML files parse successfully, retain CRLF-only line endings, contain no remaining <em> elements, and pass git diff --check. OpenPublishing.Build also passed, confirming generated-page compatibility.

[dalexsoto]

The inherited annotation links and supported italic markup now generate correctly, and the reflection contracts match Android.

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The main merge preserves all previously reviewed reflection contracts, links, supported markup, and generated output.