Skip to content

Conversation

@MUSKANNISHAD
Copy link
Contributor

Fixes #42511

Aligns DELETE request body documentation with GET semantics per RFC 9110.
Adds a warning callout and corrects the "Request has body" table entry.

@MUSKANNISHAD MUSKANNISHAD requested a review from a team as a code owner January 15, 2026 13:04
@MUSKANNISHAD MUSKANNISHAD requested review from pepelsbey and removed request for a team January 15, 2026 13:04
@github-actions github-actions bot added Content:HTTP HTTP docs size/s [PR only] 6-50 LoC changed labels Jan 15, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 15, 2026

Preview URLs

Flaws (3)

URL: /en-US/docs/Web/HTTP/Reference/Methods/DELETE
Title: DELETE request method
Flaw count: 3

  • unknown:
    • No generic content config found
    • no blog root
    • no blog root

(comment last updated: 2026-01-17 04:55:48)

@pepelsbey
Copy link
Member

Thank you! Looks good to me, but just to double-check:

@fdx-vitor-santos does it solve the issue you filed? #42511

Although a request body is technically allowed, its semantics are undefined for DELETE.

> [!WARNING]
> Although request message framing is independent of the method used, content received in a DELETE request has no generally defined semantics, cannot alter the meaning or target of the request, and might lead some implementations to reject the request.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Please don't just copy text out of the spec. It looks like the report (#42511) expects the page for DELETE to use the same wording as the page for GET, and that seems like a reasonable approach.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks for the feedback!
I’ve updated the DELETE page to use the same NOTE wording and links as the GET page, rather than copying text directly from the spec.
Please let me know if this now addresses the concern.

@wbamberg
Copy link
Collaborator

Oops, sorry @pepelsbey , I missed your review.

@MUSKANNISHAD MUSKANNISHAD force-pushed the fix-delete-request-body-semantics-clean branch 2 times, most recently from bd2fa2c to 835bb2f Compare January 16, 2026 04:53
Use the same warning wording as the GET method to clarify that
DELETE request bodies have no defined semantics and cannot affect
the request target, resolving the inconsistency reported in mdn#42511.
@MUSKANNISHAD MUSKANNISHAD force-pushed the fix-delete-request-body-semantics-clean branch from 835bb2f to fd22d2b Compare January 16, 2026 05:05
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@fdx-vitor-santos
Copy link

Many thanks for taking a look at this!

@pepelsbey yes, this PR solves the issue I had raised.

Copy link
Member

@pepelsbey pepelsbey left a comment

Choose a reason for hiding this comment

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

Perfect! Thank you everyone ❤️

Co-authored-by: wbamberg <will@bootbonnet.ca>
Copy link
Collaborator

@wbamberg wbamberg left a comment

Choose a reason for hiding this comment

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

👍 thank you @MUSKANNISHAD !

@wbamberg wbamberg merged commit 531ab7d into mdn:main Jan 17, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:HTTP HTTP docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Body and semantic information differ between GET and DELETE requests

4 participants