Document Java.Time Instant APIs

[jonathanpeppers]

Refs #276

Sources

• https://developer.android.com/reference/java/time/Instant

Validation

• XML parsing and CRLF-only line-ending checks.
• 40 distinct Android reference source anchors resolved.
• Scoped placeholder check: only four managed binding projections remain undocumented.
• Diff scope and whitespace checks.

[Copilot]

Pull request overview

Updates the Java.Time.Instant XML documentation to replace remaining placeholders and align member docs with Android reference content for java.time.Instant.

Changes:

• Replaced large blocks of “To be added.” placeholders with summaries, parameter/return descriptions, and remarks for many Instant members.
• Added Android reference links and attribution notices throughout the type and member documentation.
• Refined remarks for key properties/methods (e.g., Now, OfEpochSecond, ToEpochMilli, truncation/field queries).

---

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

[jonathanpeppers]

@dalexsoto review

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

Three Instant documentation defects remain:

• With(ITemporalAdjuster) includes scraped licensing/footer and “Last updated” text inside the member contract.
• Both Boolean IsSupported overloads omit their required return-value documentation.
• Parse(ICharSequence) labels its parameter as string, contradicting the managed Java.Lang.ICharSequence signature.

Please remove the footer, restore both return contracts, and use the correct CharSequence/ICharSequence parameter type.

[jonathanpeppers]

Addressed the remaining review feedback in 34356d7: removed the scraped footer from With(ITemporalAdjuster), restored both IsSupported return contracts, and corrected the managed parameter labels for both Parse overloads.

[dalexsoto]

The Instant contracts now have correct return documentation, parameter types, source content, ranges, and generated metadata.