Merge branch 'mdn:main' into main

anewman15 · Jun 30, 2024 · 28dfe9f · 28dfe9f
2 parents ff7683f + 959975c
commit 28dfe9f
Show file tree

Hide file tree

Showing 10 changed files with 24 additions and 20 deletions.
diff --git a/files/en-us/learn/forms/how_to_build_custom_form_controls/index.md b/files/en-us/learn/forms/how_to_build_custom_form_controls/index.md
@@ -675,8 +675,8 @@ To achieve this, we need two things:
 First, we need to add a regular {{HTMLElement("select")}} element before each instance of our custom control. There is a benefit to having this "extra" select even if our JavaScript works as hoped: we will use this select to send data from our custom control along with the rest of our form data. We will discuss this in greater depth later.
 
 ```html
-<body>
-  <form class="no-widget">
+<body class="no-widget">
+  <form>
     <select name="myFruit">
       <option>Cherry</option>
       <option>Lemon</option>

diff --git a/files/en-us/web/accessibility/seizure_disorders/index.md b/files/en-us/web/accessibility/seizure_disorders/index.md
@@ -528,10 +528,6 @@ The `update` media feature is used to query the ability of the output device to
 
 ## Developmental & Experimental Features
 
-### MDN Navigator.doNotTrack
-
-[From the documentation](/en-US/docs/Web/API/Navigator/doNotTrack): _"Returns the user's do-not-track setting. This is "1" if the user has requested not to be tracked by websites, content, or advertising"_.
-
 ### Media Queries Level 5
 
 EnvironmentMQ (Planned in Media Queries Level 5)

diff --git a/files/en-us/web/api/gpudevice/createrenderpipeline/index.md b/files/en-us/web/api/gpudevice/createrenderpipeline/index.md
@@ -192,18 +192,18 @@ The `fragment` object contains an array of objects, each of which can contain th
 
       - : One or more {{glossary("bitwise flags")}} defining the write mask to apply to the color target state. Possible flag values are:
 
-        - `GPUFlagsConstant.RED`
-        - `GPUFlagsConstant.GREEN`
-        - `GPUFlagsConstant.BLUE`
-        - `GPUFlagsConstant.ALPHA`
-        - `GPUFlagsConstant.ALL`
+        - `GPUColorWrite.RED`
+        - `GPUColorWrite.GREEN`
+        - `GPUColorWrite.BLUE`
+        - `GPUColorWrite.ALPHA`
+        - `GPUColorWrite.ALL`
 
-        If omitted, `writeMask` defaults to `GPUFlagsConstant.ALL`.
+        If omitted, `writeMask` defaults to `GPUColorWrite.ALL`.
 
         Note that multiple flags can be specified by separating values with pipe symbols, for example:
 
         ```js
-        writeMask: GPUFlagsConstant.RED | GPUFlagsConstant.ALPHA;
+        writeMask: GPUColorWrite.RED | GPUColorWrite.ALPHA;
         ```
 
 ### `multisample` object structure

diff --git a/files/en-us/web/api/mediastreamtrack/index.md b/files/en-us/web/api/mediastreamtrack/index.md
@@ -18,7 +18,7 @@ Some user agents subclass this interface to provide more precise information or
 In addition to the properties listed below, `MediaStreamTrack` has constrainable properties which can be set using {{domxref("MediaStreamTrack.applyConstraints", "applyConstraints()")}} and accessed using {{domxref("MediaStreamTrack.getConstraints", "getConstraints()")}} and {{domxref("MediaStreamTrack.getSettings", "getSettings()")}}. See [Capabilities, constraints, and settings](/en-US/docs/Web/API/Media_Capture_and_Streams_API/Constraints) to learn how to correctly work with constrainable properties. Not doing so correctly will result in your code being unreliable.
 
 - {{domxref("MediaStreamTrack.contentHint")}}
-  - : A string that may be used by the web application to provide a hint as to what type of content the track contains to guide how it should be treated by API consumers.
+  - : A string that may be used by the web application to provide a hint as to what type of content the track contains to guide how it should be treated by API consumers. Allowable values depend on the value of the {{domxref("MediaStreamTrack.kind")}} property.
 - {{domxref("MediaStreamTrack.enabled")}}
 
   - : A Boolean whose value of `true` if the track is enabled, that is allowed to render the media source stream; or `false` if it is disabled, that is not rendering the media source stream but silence and blackness. If the track has been disconnected, this value can be changed but has no more effect.

diff --git a/files/en-us/web/api/navigator/donottrack/index.md b/files/en-us/web/api/navigator/donottrack/index.md
@@ -15,6 +15,10 @@ The **`Navigator.doNotTrack`** property returns the user's Do Not Track setting,
 
 The value of the property reflects that of the {{httpheader("DNT")}} HTTP header, i.e. values of `"1"`, `"0"`, or `null`.
 
+The whole DNT (Do Not Track) specification has been discontinued. The mechanism design was flawed, because it was a cooperative feature between users, websites, and browsers. The idea is that the user tells the _website_ to not track them, and the _website_ would comply. However, there is no strict enforcement of this policy, so advertisement websites ignored the DNT header and tracked users anyway. The feature is therefore useless. Moreover, it is harmful as it leaves more user [fingerprint](/en-US/docs/Glossary/Fingerprinting) in the header, which can be used to track users even more.
+
+Browsers are exploring other more enforceable privacy features, such as [global privacy control](/en-US/docs/Web/API/Navigator/globalPrivacyControl), restriction to third-party cookies, and more.
+
 ## Value
 
 A string or `null`.
@@ -28,7 +32,7 @@ console.log(navigator.doNotTrack);
 
 ## Specifications
 
-{{Specifications}}
+Part of the discontinued [Tracking Preference Expression (DNT)](https://www.w3.org/TR/tracking-dnt/#dom-navigator-donottrack) specification.
 
 ## Browser compatibility
 

diff --git a/files/en-us/web/api/screenorientation/lock/index.md b/files/en-us/web/api/screenorientation/lock/index.md
@@ -8,7 +8,7 @@ browser-compat: api.ScreenOrientation.lock
 
 {{APIRef("Screen Orientation")}}
 
-The **`lock()`** property of the {{domxref("ScreenOrientation")}} interface locks the orientation of the containing document to the specified orientation.
+The **`lock()`** method of the {{domxref("ScreenOrientation")}} interface locks the orientation of the containing document to the specified orientation.
 
 Typically orientation locking is only enabled on mobile devices, and when the browser context is full screen.
 If locking is supported, then it must work for all the parameter values listed below.

diff --git a/files/en-us/web/api/screenorientation/unlock/index.md b/files/en-us/web/api/screenorientation/unlock/index.md
@@ -8,7 +8,7 @@ browser-compat: api.ScreenOrientation.unlock
 
 {{APIRef("Screen Orientation")}}
 
-The **`unlock()`** property of the
+The **`unlock()`** method of the
 {{domxref("ScreenOrientation")}} interface unlocks the orientation of the containing
 document from its default orientation.
 

diff --git a/files/en-us/web/http/headers/dnt/index.md b/files/en-us/web/http/headers/dnt/index.md
@@ -10,6 +10,8 @@ browser-compat: http.headers.DNT
 
 {{HTTPSidebar}}{{Deprecated_header}}{{non-standard_header}}
 
+> **Note:** The DNT (Do Not Track) specification has been discontinued. See {{domxref("Navigator.doNotTrack")}} for more information.
+
 The **`DNT`** (**D**o **N**ot
 **T**rack) request header indicates the user's tracking preference. It lets
 users indicate whether they would prefer privacy rather than personalized content.
@@ -59,7 +61,7 @@ navigator.doNotTrack; // "0", "1" or null
 
 ## Specifications
 
-{{Specifications}}
+Part of the discontinued [Tracking Preference Expression (DNT)](https://www.w3.org/TR/tracking-dnt/#dnt-header-field) specification.
 
 ## Browser compatibility
 

diff --git a/files/en-us/web/http/headers/tk/index.md b/files/en-us/web/http/headers/tk/index.md
@@ -10,6 +10,8 @@ browser-compat: http.headers.Tk
 
 {{HTTPSidebar}}{{Deprecated_header}}{{non-standard_header}}
 
+> **Note:** The DNT (Do Not Track) specification has been discontinued. See {{domxref("Navigator.doNotTrack")}} for more information.
+
 The **`Tk`** response header indicates the tracking status that
 applied to the corresponding request.
 
@@ -80,7 +82,7 @@ Tk: N
 
 ## Specifications
 
-{{Specifications}}
+Part of the discontinued [Tracking Preference Expression (DNT)](https://www.w3.org/TR/tracking-dnt/#response-header-field) specification.
 
 ## Browser compatibility
 

diff --git a/files/en-us/web/javascript/reference/functions/arrow_functions/index.md b/files/en-us/web/javascript/reference/functions/arrow_functions/index.md
@@ -122,7 +122,7 @@ The braces can only be omitted if the function directly returns an expression. I
 };
 ```
 
-Arrow functions are always unnamed. If the arrow function needs to call itself, use a named function expression instead. You can also assign the arrow function to a variable so it has a name.
+Arrow functions are not inherently associated with a name. If the arrow function needs to call itself, use a named function expression instead. You can also assign the arrow function to a variable, allowing you to refer to it through that variable.
 
 ```js
 // Traditional Function
-Original file line number
+Diff line change
@@ Expand Up @@
     };
     ```
-    Arrow functions are always unnamed. If the arrow function needs to call itself, use a named function expression instead. You can also assign the arrow function to a variable so it has a name.
+    Arrow functions are not inherently associated with a name. If the arrow function needs to call itself, use a named function expression instead. You can also assign the arrow function to a variable, allowing you to refer to it through that variable.
     ```js
     // Traditional Function
@@ Expand Down @@