Document Apache HTTP client APIs

[jonathanpeppers]

Summary

• Document 87 source-supported placeholders in Org.Apache.Http.Client.
• Leave 30 placeholders without safely applicable source documentation unchanged; issue Add XML documentation for Org.Apache.Http.Client #270 remains open.

Refs #270

Sources

• Android 6.0 Apache HTTP Client removal notice
• AOSP Apache HTTP client package and authoritative Java sources: package.html, CircularRedirectException.java, CookieStore.java, CredentialsProvider.java, HttpClient.java, HttpRequestRetryHandler.java, RedirectHandler.java, RequestDirector.java, ResponseHandler.java, UserTokenHandler.java, NonRepeatableRequestException.java, and RedirectException.java.

Validation

• Parsed all 16 scoped XML files with PowerShell [xml].
• Confirmed CRLF line endings for all 16 scoped XML files.
• Ran git diff --check and verified the diff is limited to docs/xml/Org.Apache.Http.Client/ and docs/xml/ns-Org.Apache.Http.Client.xml.
• Counted scoped To be added. placeholders: 117 before, 30 after.

[Copilot]

Pull request overview

This PR fills in previously placeholder XML documentation for the Org.Apache.Http.Client namespace, using source-supported descriptions where available, and adds a namespace-level summary to improve generated API docs.

Changes:

• Replace multiple To be added. placeholders with concrete <summary>, <param>, <returns>, and <value> documentation across key Org.Apache.Http.Client types.
• Add a meaningful namespace summary in ns-Org.Apache.Http.Client.xml.
• Improve documentation for async extension methods on IHttpClient.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
docs/xml/Org.Apache.Http.Client/RedirectException.xml	Documents constructor parameters for RedirectException.
docs/xml/Org.Apache.Http.Client/NonRepeatableRequestException.xml	Documents constructor parameter for NonRepeatableRequestException.
docs/xml/Org.Apache.Http.Client/IUserTokenHandler.xml	Replaces placeholder return docs with a meaningful description.
docs/xml/Org.Apache.Http.Client/IResponseHandler.xml	Documents return value semantics for response handler processing.
docs/xml/Org.Apache.Http.Client/IRequestDirector.xml	Documents return value semantics for request execution.
docs/xml/Org.Apache.Http.Client/IRedirectHandler.xml	Documents return values for redirect determination methods.
docs/xml/Org.Apache.Http.Client/IHttpRequestRetryHandler.xml	Documents boolean return value for retry decisions.
docs/xml/Org.Apache.Http.Client/IHttpClientExtensions.xml	Adds docs for async IHttpClient extension methods (params/summaries/returns).
docs/xml/Org.Apache.Http.Client/IHttpClient.xml	Adds missing <returns>/<value> docs for core client members.
docs/xml/Org.Apache.Http.Client/ICredentialsProvider.xml	Documents credentials lookup return value.
docs/xml/Org.Apache.Http.Client/ICookieStore.xml	Documents cookie store parameter/return/value semantics.
docs/xml/Org.Apache.Http.Client/CircularRedirectException.xml	Documents constructor parameters for CircularRedirectException.
docs/xml/ns-Org.Apache.Http.Client.xml	Adds namespace-level summary text.

---

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

[jonathanpeppers]

@dalexsoto review