Document Apache HTTP implementations

[jonathanpeppers]

Closes #301

Sources

• Android 6.0 Apache HTTP client removal notice
• AOSP Apache HTTP implementation sources (android-4.4.4_r2)

Validation

• Parsed all 13 changed XML files with System.Xml.XmlDocument.
• Confirmed no To be added. placeholders remain in Org.Apache.Http.Impl or its namespace XML.
• Ran git diff --check.

[Copilot]

Pull request overview

This PR updates the XML documentation for the Org.Apache.Http.Impl namespace to replace To be added. placeholders with meaningful summaries/parameter/return descriptions, aligning the generated API docs with the underlying Apache HTTP implementation types exposed in Mono.Android.

Changes:

• Replaced placeholder summaries across core connection/strategy/factory types in Org.Apache.Http.Impl.
• Added parameter and return-value documentation for key methods/properties (e.g., socket binding, buffer creation, metrics lookups).
• Added a namespace-level summary for Org.Apache.Http.Impl.

Reviewed changes

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

Show a summary per file

File	Description
docs/xml/Org.Apache.Http.Impl/SocketHttpServerConnection.xml	Adds class/member docs for socket-backed HTTP server connections.
docs/xml/Org.Apache.Http.Impl/SocketHttpClientConnection.xml	Adds class/member docs for socket-backed HTTP client connections.
docs/xml/Org.Apache.Http.Impl/NoConnectionReuseStrategy.xml	Documents the “never reuse” connection reuse strategy (one doc accuracy fix requested).
docs/xml/Org.Apache.Http.Impl/HttpConnectionMetricsImpl.xml	Documents connection metrics collection and metric accessors.
docs/xml/Org.Apache.Http.Impl/EnglishReasonPhraseCatalog.xml	Documents English HTTP status reason phrase lookup behavior.
docs/xml/Org.Apache.Http.Impl/DefaultHttpServerConnection.xml	Documents default server connection implementation details.
docs/xml/Org.Apache.Http.Impl/DefaultHttpClientConnection.xml	Documents default client connection implementation details.
docs/xml/Org.Apache.Http.Impl/DefaultHttpResponseFactory.xml	Documents default HTTP response creation APIs.
docs/xml/Org.Apache.Http.Impl/DefaultHttpRequestFactory.xml	Documents default HTTP request creation APIs.
docs/xml/Org.Apache.Http.Impl/DefaultConnectionReuseStrategy.xml	Documents default connection reuse decision logic entry points.
docs/xml/Org.Apache.Http.Impl/AbstractHttpServerConnection.xml	Documents base server connection behavior and extensibility points.
docs/xml/Org.Apache.Http.Impl/AbstractHttpClientConnection.xml	Documents base client connection behavior and extensibility points.
docs/xml/ns-Org.Apache.Http.Impl.xml	Adds a namespace-level summary for Org.Apache.Http.Impl.

---

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