Skip to content

Conversation

@bsmth
Copy link
Contributor

@bsmth bsmth commented Apr 8, 2025

Summary

The MDN HTTP reference docs have a new scheme. The following sections have a Reference/ prefix now:

  • Headers
  • Methods
  • Statuses

So, the new scheme looks like:

- Web/HTTP/Headers/
+ Web/HTTP/Reference/Headers/

- Web/HTTP/Status/
+ Web/HTTP/Reference/Status/

- Web/HTTP/Methods/
+ Web/HTTP/Reference/Methods/

Redirects are in place on MDN for all existing URLs, but we should update the URL prefix used to avoid sending readers to 301s.

See also:

Screenshots (optional)

N/A

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

@github-actions github-actions bot added product:cache Issues or PRs related to Cache product:cloudflare-one product:ddos-protection product:page-shield Issues or PRs related to Page Shield product:pages product:r2 R2 object storage: https://developers.cloudflare.com/r2 product:radar product:rules Related to rules product:speed product:stream Related to Stream product product:waf product:waiting-room Related to Waiting Room product product:workers Related to Workers product labels Apr 8, 2025
* **Strict** - Cookies will only be sent in a first-party context and not be sent along with requests initiated by third party websites.

Refer to the [Mozilla documentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite) for more information.
Refer to the [Mozilla documentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#samesitesamesite-value) for more information.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

/SameSite is not a sub-page now, so I'm linking to #samesitesamesite-value anchor. There's another occurrence below, I believe

## Background

The [`SameSite` attribute of a cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite) specifies whether that cookie can be shared with other domains that load on the same page (ad banners, iFrames). By default, browsers do not send cookies on cross-site subrequests to prevent attackers from stealing or manipulating information present in your cookies.
The [`SameSite` attribute of a cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie/SameSite) specifies whether that cookie can be shared with other domains that load on the same page (ad banners, iFrames). By default, browsers do not send cookies on cross-site subrequests to prevent attackers from stealing or manipulating information present in your cookies.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

See comment above:

Suggested change
The [`SameSite` attribute of a cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie/SameSite) specifies whether that cookie can be shared with other domains that load on the same page (ad banners, iFrames). By default, browsers do not send cookies on cross-site subrequests to prevent attackers from stealing or manipulating information present in your cookies.
The [`SameSite` attribute of a cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#samesitesamesite-value) specifies whether that cookie can be shared with other domains that load on the same page (ad banners, iFrames). By default, browsers do not send cookies on cross-site subrequests to prevent attackers from stealing or manipulating information present in your cookies.

@RebeccaTamachiro RebeccaTamachiro merged commit 4b9a727 into cloudflare:production Apr 8, 2025
5 checks passed
@workers-devprod workers-devprod added the contribution [Holopin] Recognizes a docs contribution, big or small label Apr 8, 2025
@holopin-bot
Copy link

holopin-bot bot commented Apr 8, 2025

Congratulations @bsmth, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cm98nikv303040cl5sdkdzx27

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!

@bsmth bsmth deleted the mdn-http-links branch April 8, 2025 16:09
RebeccaTamachiro pushed a commit that referenced this pull request Apr 21, 2025
* chore: Fix redirected MDN URLs for HTTP headers docs

* chore: Fix redirected MDN URLs for HTTP status docs

* chore: Fix redirected MDN URLs for HTTP methods docs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution [Holopin] Recognizes a docs contribution, big or small product:cache Issues or PRs related to Cache product:cloudflare-one product:ddos-protection product:page-shield Issues or PRs related to Page Shield product:pages product:r2 R2 object storage: https://developers.cloudflare.com/r2 product:radar product:rules Related to rules product:speed product:stream Related to Stream product product:waf product:waiting-room Related to Waiting Room product product:workers Related to Workers product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.