Skip to content

Document Apache cookie spec factory - #556

Merged
jonathanpeppers merged 3 commits into
mainfrom
jonathanpeppers-document-apache-cookies
Aug 18, 2026
Merged

Document Apache cookie spec factory#556
jonathanpeppers merged 3 commits into
mainfrom
jonathanpeppers-document-apache-cookies

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Member

Refs #266

Sources

Validation

  • Parsed docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml as XML.
  • Confirmed CRLF-only line endings, no remaining placeholders in the scoped file, and a clean focused diff.

Refs #266

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

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 replaces “To be added.” placeholders in the XML documentation for Org.Apache.Http.Cookies.ICookieSpecFactory, aligning the docs more closely with the upstream Apache HttpClient CookieSpecFactory API and improving IntelliSense quality for this namespace.

Changes:

  • Added a concrete type-level <summary> for ICookieSpecFactory.
  • Documented the NewInstance(IHttpParams params) method’s parameter, summary, and return value.

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

Comment thread docs/xml/Org.Apache.Http.Cookies/ICookieSpecFactory.xml Outdated
Refs #266

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

Copy link
Copy Markdown
Member Author

@dalexsoto review

2 similar comments
@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

@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.

The new ICookieSpecFactory summaries and parameter/return text closely derive from Apache HttpClient Javadoc, but the page attributes them only to AOSP under CC BY 2.5. Please add the appropriate Apache HttpClient/Apache-2.0 attribution and required notices, or replace the text with independently authored documentation approved under repository policy.

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

Copilot-Session: b143e1ee-57ea-434e-a1a5-ce76b1da1037
@jonathanpeppers

Copy link
Copy Markdown
Member Author

Addressed in 2556ec8 by replacing the Apache-derived wording with independently authored documentation while retaining the existing API references and repository attribution.

@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.

The cookie specification factory now uses independently authored, accurate documentation with valid signatures, references, and attribution.

@jonathanpeppers
jonathanpeppers merged commit 457e2f6 into main Aug 18, 2026
3 checks passed
@jonathanpeppers
jonathanpeppers deleted the jonathanpeppers-document-apache-cookies branch August 18, 2026 21:22
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