content
content copied to clipboard
mdn
feat: editorial review: Update cookie docs
Description
https://github.com/mdn/content/pull/31848 contains the engineering technical review for my work on updating the MDN cookie docs, which has been completed and approved. Thank you to @samdutton for your thorough and detailed review work.
This is a new PR based on the same branch, which is intended to contain the editorial review for the same work.
Background information
This PR updates some of the cookie information found on MDN, according to the cookie docs proposal that was made available a while ago.
While this PR doesn't make all of the changes listed in the proposal doc, it does the following:
- Update the HTTP cookies guide to clean up the structure a bit, modernize the information, and move some of the information to other places.
- Add a new Third-party cookies article to provide a single detailed definition of 3PC, the issues associated with them, and how to handle those issues.
- Clean up the Privacy landing page to remove some of the browser-specific information, move some of the content to more appropriate places, and generally clean up/improve.
- Update all the pages that provide their own definition of third-party cookies/tracking and link them to the one single definition on the new 3PC article instead.
Motivation
Additional details
Related issues and pull requests
Preview URLs (24 pages)
/en-US/docs/Mozilla/Add-ons/WebExtensions/API/privacy/websites/en-US/docs/Web/API/CredentialsContainer/get/en-US/docs/Web/API/Document/cookie/en-US/docs/Web/API/Document/hasStorageAccess/en-US/docs/Web/API/Document/requestStorageAccessFor/en-US/docs/Web/API/Document/requestStorageAccess/en-US/docs/Web/API/FedCM_API/en-US/docs/Web/API/IdentityProvider/getUserInfo_static/en-US/docs/Web/API/Navigator/cookieEnabled/en-US/docs/Web/API/Storage_Access_API/Related_website_sets/en-US/docs/Web/API/Storage_Access_API/Using/en-US/docs/Web/API/Storage_Access_API/en-US/docs/Web/API/Topics_API/en-US/docs/Web/API/XMLHttpRequest/withCredentials/en-US/docs/Web/HTTP/Cookies/en-US/docs/Web/Privacy/Firefox_tracking_protection/en-US/docs/Web/Privacy/Privacy_sandbox/Partitioned_cookies/en-US/docs/Web/Privacy/Redirect_tracking_protection/en-US/docs/Web/Privacy/State_Partitioning/en-US/docs/Web/Privacy/Storage_Access_Policy/en-US/docs/Web/Privacy/Third-party_cookies/en-US/docs/Web/Privacy/en-US/docs/Web/Security/Types_of_attacks/en-US/docs/Web/Security
Flaws (3)
Note! 22 documents with no flaws that don't need to be listed. 🎉
URL: /en-US/docs/Web/Privacy/Third-party_cookies
Title: Third-party cookies
Flaw count: 2
- images:
External image URL
- broken_links:
Can't resolve /en-US/docs/Web/Privacy/Partitioned_cookies
URL: /en-US/docs/Web/HTTP/Cookies
Title: Using HTTP cookies
Flaw count: 1
- images:
External image URL
External URLs (33)
URL: /en-US/docs/Web/Privacy
Title: Privacy on the web
- https://addons.mozilla.org/en-GB/firefox/addon/clearurls/ (1 time) (Note! This may be a new URL 👀)
- https://example.com/article/?id=62yhgt1a&campaign=902 (1 time) (Note! This may be a new URL 👀)
- https://support.google.com/youtube/answer/171780 (1 time) (Note! This may be a new URL 👀)
- https://web.dev/learn/privacy/ (1 time) (Note! This may be a new URL 👀)
- https://web.dev/learn/privacy/fingerprinting/ (1 time) (Note! This may be a new URL 👀)
- https://www.permissionspolicy.com/ (1 time) (Note! This may be a new URL 👀)
URL: /en-US/docs/Web/Privacy/Redirect_tracking_protection
Title: Redirect tracking protection
- https://bugzil.la/1643045 (1 time) (Note! This may be a new URL 👀)
- https://support.mozilla.org/en-US/kb/enhanced-tracking-protection-firefox-desktop (1 time) (Note! This may be a new URL 👀)
URL: /en-US/docs/Web/Privacy/Third-party_cookies
Title: Third-party cookies
- https://blog.mozilla.org/en/products/firefox/firefox-rolls-out-total-cookie-protection-by-default-to-all-users-worldwide/ (1 time) (Note! This may be a new URL 👀)
- https://brave.com/ (1 time) (Note! This may be a new URL 👀)
- https://developer.chrome.com/docs/devtools/issues/ (1 time) (Note! This may be a new URL 👀)
- https://developer.chrome.com/docs/privacy-sandbox/attribution-reporting/ (1 time) (Note! This may be a new URL 👀)
- https://developer.chrome.com/docs/privacy-sandbox/private-state-tokens/ (1 time) (Note! This may be a new URL 👀)
- https://developer.chrome.com/docs/privacy-sandbox/protected-audience/ (1 time) (Note! This may be a new URL 👀)
- https://developers.google.com/privacy-sandbox/3pcd/prepare/audit-cookies (1 time) (Note! This may be a new URL 👀)
- https://en.wikipedia.org/wiki/General_Data_Protection_Regulation (1 time) (Note! This may be a new URL 👀)
- https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/ (1 time) (Note! This may be a new URL 👀)
- https://learn.microsoft.com/en-us/microsoft-edge/web-platform/tracking-prevention (1 time) (Note! This may be a new URL 👀)
- https://support.mozilla.org/en-US/kb/enhanced-tracking-protection-firefox-desktop (1 time) (Note! This may be a new URL 👀)
- https://webkit.org/tracking-prevention-policy/ (1 time) (Note! This may be a new URL 👀)
- https://webkit.org/tracking-prevention/ (1 time) (Note! This may be a new URL 👀)
- https://wiki.mozilla.org/Security/Anti_tracking_policy (1 time) (Note! This may be a new URL 👀)
- https://www.oag.ca.gov/privacy/ccpa (1 time) (Note! This may be a new URL 👀)
URL: /en-US/docs/Web/HTTP/Cookies
Title: Using HTTP cookies
- https://api.rubyonrails.org/classes/ActionDispatch/Cookies.html (1 time) (Note! This may be a new URL 👀)
- https://developer.chrome.com/docs/devtools/progressive-web-apps (1 time) (Note! This may be a new URL 👀)
- https://docs.python.org/3/library/http.cookies.html (1 time) (Note! This may be a new URL 👀)
- https://en.wikipedia.org/wiki/Defense_in_depth_(computing) (1 time) (Note! This may be a new URL 👀)
- https://firefox-source-docs.mozilla.org/devtools-user/storage_inspector/index.html (1 time) (Note! This may be a new URL 👀)
- https://jwt.io/ (1 time) (Note! This may be a new URL 👀)
- https://nodejs.org/dist/latest-v14.x/docs/api/http.html (1 time) (Note! This may be a new URL 👀)
- https://policies.google.com/technologies/types (1 time) (Note! This may be a new URL 👀)
- https://www.mozilla.org/en-US/privacy/websites/ (1 time) (Note! This may be a new URL 👀)
- https://www.php.net/manual/en/function.setcookie.php (1 time) (Note! This may be a new URL 👀)
(comment last updated: 2024-04-24 15:53:33)
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}
In addition to the inline comments, we need to double-check if the drawio files can be stored there. I hope this, but I don't remember the outcome of a former discussion (@bsmth: do you remember?)
Thanks a lot for checking. Could we please move them to https://github.com/mdn/shared-assets/tree/main/images/diagrams? There is also GH pages active on that repo, so you can reference images / SVG like: https://mdn.github.io/shared-assets/images/examples/balloon-small.jpg
Related discussions:
- https://github.com/orgs/mdn/discussions/94
- https://github.com/orgs/mdn/discussions/631#discussioncomment-8222396
In addition to the inline comments, we need to double-check if the drawio files can be stored there. I hope this, but I don't remember the outcome of a former discussion (@bsmth: do you remember?)
Thanks a lot for checking. Could we please move them to https://github.com/mdn/shared-assets/tree/main/images/diagrams? There is also GH pages active on that repo, so you can reference images / SVG like: https://mdn.github.io/shared-assets/images/examples/balloon-small.jpg
Related discussions:
* https://github.com/orgs/mdn/discussions/94 * https://github.com/orgs/mdn/discussions/631#discussioncomment-8222396
Ah, thanks a lot for bringing this to my attention, @teoli2003, and thanks for the info, @bsmth. This discussion completely passed me by; I am really glad we have a place for shared images now!
I will immediately put my image files on the shared-assets repo, before I continue with the rest of the work in this PR.
@teoli2003 thanks for the fabulous review. I've responded to everything now. Back to you!