Skip to content

Document Java.Net HTTP status values - #628

Merged
jonathanpeppers merged 2 commits into
mainfrom
jonathanpeppers-document-java-net-apis-695
Aug 17, 2026
Merged

Document Java.Net HTTP status values#628
jonathanpeppers merged 2 commits into
mainfrom
jonathanpeppers-document-java-net-apis-695

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Member

Summary

  • Document all 36 Java.Net.HttpStatus values mapped from java.net.HttpURLConnection constants.

Refs #232

Sources

Validation

  • Parsed docs/xml/Java.Net/HttpStatus.xml with PowerShell XML parsing.
  • Confirmed CRLF-only line endings (993 CRLF, 0 lone LF).
  • Ran git diff --check.

Refs #232

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 17, 2026 02:27
@jonathanpeppers
jonathanpeppers enabled auto-merge (squash) August 17, 2026 02:27

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR improves the completeness of the Java.Net XML API documentation by replacing placeholder text in Java.Net.HttpStatus with concrete summaries for each mapped HTTP status value (mirroring Android java.net.HttpURLConnection constants), supporting the broader effort in #232 to eliminate “To be added” placeholders.

Changes:

  • Replaced all remaining To be added. placeholders in Java.Net.HttpStatus field docs with specific HTTP status summaries.
  • Ensured coverage across all 36 Java.Net.HttpStatus values mapped from java.net.HttpURLConnection.

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

@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

@dalexsoto dalexsoto left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ServerError maps to Android's deprecated HTTP_SERVER_ERROR, which is misplaced and replaced by InternalError, but the new summary presents it as an ordinary 500 value. Put the deprecation warning and replacement in the published summary, or mark the enum value obsolete upstream and regenerate.

Explain that ServerError maps to the misplaced deprecated Android constant and direct users to InternalError.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 3acbf5b4-9edd-468a-9051-d61e7f774c07
@jonathanpeppers

Copy link
Copy Markdown
Member Author

Addressed in 4a065d3: ServerError now explicitly warns that the mapped Android constant is deprecated and misplaced, and directs users to InternalError. XML parsing, CRLF-only line endings, and git diff --check all pass.

@jonathanpeppers

jonathanpeppers commented Aug 17, 2026

Copy link
Copy Markdown
Member Author

Addressed in 4a065d3. The published ServerError summary now warns that the mapped Android constant is deprecated and misplaced, and directs users to InternalError. XML parsing, CRLF line endings, and git diff --check all pass.

@dalexsoto dalexsoto left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ServerError now clearly documents the deprecated mapping and valid InternalError replacement; the status values and generated output are correct.

@jonathanpeppers
jonathanpeppers merged commit 5c55adf into main Aug 17, 2026
3 checks passed
@jonathanpeppers
jonathanpeppers deleted the jonathanpeppers-document-java-net-apis-695 branch August 17, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants