From 46f662b65ac56fa9d7775f2b3b7e711e4f62e094 Mon Sep 17 00:00:00 2001 From: wbamberg Date: Sun, 22 Aug 2021 22:42:38 -0700 Subject: [PATCH] Fix bad note names (#8219) * Fix a few manually to prepare for auto-fixing * Availability: -> Note: * Fix random intro words --- .../web/api/angle_instanced_arrays/index.html | 2 +- .../createjavascriptnode/index.html | 2 +- .../audioworkletprocessor/process/index.html | 2 +- .../tutorial/transformations/index.html | 2 +- files/en-us/web/api/clipboard/index.html | 2 +- .../api/closeevent/initcloseevent/index.html | 2 +- files/en-us/web/api/cssstylesheet/index.html | 2 +- .../web/api/document/adoptnode/index.html | 2 +- .../web/api/document_object_model/index.html | 5 ++--- .../api/element/mousewheel_event/index.html | 2 +- .../mozmousepixelscroll_event/index.html | 2 +- .../comparison_of_event_targets/index.html | 6 +----- files/en-us/web/api/event/initevent/index.html | 2 -- .../en-us/web/api/ext_blend_minmax/index.html | 2 +- .../web/api/ext_color_buffer_float/index.html | 2 +- .../api/ext_color_buffer_half_float/index.html | 2 +- .../api/ext_disjoint_timer_query/index.html | 2 +- files/en-us/web/api/ext_float_blend/index.html | 2 +- files/en-us/web/api/ext_frag_depth/index.html | 2 +- .../web/api/ext_shader_texture_lod/index.html | 2 +- files/en-us/web/api/ext_srgb/index.html | 2 +- .../ext_texture_compression_bptc/index.html | 2 +- .../ext_texture_compression_rgtc/index.html | 2 +- .../ext_texture_filter_anisotropic/index.html | 2 +- .../web/api/ext_texture_norm16/index.html | 2 +- .../filereader/readasarraybuffer/index.html | 3 +-- .../web/api/filereader/readastext/index.html | 3 +-- .../onmousewheel/index.html | 6 +----- .../web/api/htmlelement/dataset/index.html | 8 +++----- .../api/htmlelement/offsetparent/index.html | 6 ++---- .../web/api/htmlimageelement/image/index.html | 5 ++--- .../web/api/keyboardevent/charcode/index.html | 4 ++-- .../api/keyboardevent/initkeyevent/index.html | 8 ++++---- .../en-us/web/api/mousescrollevent/index.html | 4 ++-- files/en-us/web/api/mousewheelevent/index.html | 4 ++-- .../web/api/navigation_timing_api/index.html | 2 +- .../en-us/web/api/node/appendchild/index.html | 3 +-- .../web/api/oes_element_index_uint/index.html | 2 +- .../web/api/oes_fbo_render_mipmap/index.html | 2 +- .../api/oes_standard_derivatives/index.html | 2 +- .../en-us/web/api/oes_texture_float/index.html | 2 +- .../api/oes_texture_float_linear/index.html | 2 +- .../web/api/oes_texture_half_float/index.html | 2 +- .../oes_texture_half_float_linear/index.html | 2 +- .../web/api/oes_vertex_array_object/index.html | 2 +- files/en-us/web/api/ovr_multiview2/index.html | 2 +- .../web/api/page_visibility_api/index.html | 2 +- .../api/paymentcurrencyamount/value/index.html | 2 +- files/en-us/web/api/pointer_events/index.html | 2 +- .../web/api/storagemanager/estimate/index.html | 2 +- .../api/svganimatedstring/animval/index.html | 2 +- .../web/api/uievent/inituievent/index.html | 4 ++-- .../web/api/web_authentication_api/index.html | 2 +- .../api/webgl_color_buffer_float/index.html | 2 +- .../webgl_compressed_texture_astc/index.html | 2 +- .../webgl_compressed_texture_etc/index.html | 2 +- .../webgl_compressed_texture_etc1/index.html | 2 +- .../webgl_compressed_texture_pvrtc/index.html | 2 +- .../webgl_compressed_texture_s3tc/index.html | 2 +- .../index.html | 2 +- .../api/webgl_debug_renderer_info/index.html | 2 +- .../web/api/webgl_debug_shaders/index.html | 2 +- .../web/api/webgl_depth_texture/index.html | 2 +- .../web/api/webgl_draw_buffers/index.html | 2 +- .../web/api/webgl_lose_context/index.html | 2 +- .../en-us/web/api/webgl_multi_draw/index.html | 2 +- .../web/api/webglvertexarrayobject/index.html | 2 +- .../writing_websocket_servers/index.html | 18 ++++++------------ files/en-us/web/api/wheelevent/index.html | 4 ++-- files/en-us/web/api/window/open/index.html | 15 +++++++-------- 70 files changed, 93 insertions(+), 119 deletions(-) diff --git a/files/en-us/web/api/angle_instanced_arrays/index.html b/files/en-us/web/api/angle_instanced_arrays/index.html index de3a35646cedbbd..03a444dfa697b5b 100644 --- a/files/en-us/web/api/angle_instanced_arrays/index.html +++ b/files/en-us/web/api/angle_instanced_arrays/index.html @@ -15,7 +15,7 @@

WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

-

Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default and the constants and methods are available without the "ANGLE" suffix.

+

Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default and the constants and methods are available without the "ANGLE" suffix.

Despite the name "ANGLE", this extension works on any device if the hardware supports it and not just on Windows when using the ANGLE library. "ANGLE" just indicates that this extension has been written by the ANGLE library authors.

diff --git a/files/en-us/web/api/audiocontext/createjavascriptnode/index.html b/files/en-us/web/api/audiocontext/createjavascriptnode/index.html index d957b32a9eb3a57..0378cb66bb16745 100644 --- a/files/en-us/web/api/audiocontext/createjavascriptnode/index.html +++ b/files/en-us/web/api/audiocontext/createjavascriptnode/index.html @@ -17,7 +17,7 @@ JavaScript.

-

Important: This method is obsolete, and has been renamed to +

Note: This method is obsolete, and has been renamed to {{domxref("BaseAudioContext/createScriptProcessor", "AudioContext.createScriptProcessor()")}}. See also {{domxref("ScriptProcessorNode")}}.

diff --git a/files/en-us/web/api/audioworkletprocessor/process/index.html b/files/en-us/web/api/audioworkletprocessor/process/index.html index b31244ca03625e0..cb48d319213d3c0 100644 --- a/files/en-us/web/api/audioworkletprocessor/process/index.html +++ b/files/en-us/web/api/audioworkletprocessor/process/index.html @@ -30,7 +30,7 @@ invoked to do so.

-

Important: Currently, audio data blocks are always 128 frames +

Note: Currently, audio data blocks are always 128 frames long—that is, they contain 128 32-bit floating-point samples for each of the inputs' channels. However, plans are already in place to revise the specification to allow the size of the audio blocks to be changed depending on circumstances (for example, if the diff --git a/files/en-us/web/api/canvas_api/tutorial/transformations/index.html b/files/en-us/web/api/canvas_api/tutorial/transformations/index.html index e8a151aceef2d0e..6c5f66e52c266a5 100644 --- a/files/en-us/web/api/canvas_api/tutorial/transformations/index.html +++ b/files/en-us/web/api/canvas_api/tutorial/transformations/index.html @@ -125,7 +125,7 @@

A rotate example

In this example, we'll use the rotate() method to first rotate a rectangle from the canvas origin and then from the center of the rectangle itself with the help of translate().

-

Reminder: Angles are in radians, not degrees. To convert, we are using: radians = (Math.PI/180)*degrees.

+

Note: Angles are in radians, not degrees. To convert, we are using: radians = (Math.PI/180)*degrees.

function draw() {
diff --git a/files/en-us/web/api/clipboard/index.html b/files/en-us/web/api/clipboard/index.html
index 53c4e9bb371c20b..0d996c48de7166a 100644
--- a/files/en-us/web/api/clipboard/index.html
+++ b/files/en-us/web/api/clipboard/index.html
@@ -30,7 +30,7 @@
 
All of the Clipboard API methods operate asynchronously; they return a {{jsxref("Promise")}} which is resolved once the clipboard access has been completed. The promise is rejected if clipboard access is denied.

 
 

-
The clipboard is a data buffer that is used for short-term, data storage and/or data transfers, this can be between documents or applications

+
Note: The clipboard is a data buffer that is used for short-term, data storage and/or data transfers, this can be between documents or applications

   It is usually implemented as an anonymous, temporary data buffer, sometimes called the paste buffer, that can be accessed from most or all programs within the environment via defined programming interfaces.

 
 
A typical application accesses clipboard functionality by mapping user input such as keybindings, menu selections, etc. to these interfaces.

diff --git a/files/en-us/web/api/closeevent/initcloseevent/index.html b/files/en-us/web/api/closeevent/initcloseevent/index.html
index 0d05cf7f97514ee..b01e5de4c05e9db 100644
--- a/files/en-us/web/api/closeevent/initcloseevent/index.html
+++ b/files/en-us/web/api/closeevent/initcloseevent/index.html
@@ -21,7 +21,7 @@
 	Once dispatched, it doesn't do anything anymore.

 
 

-	
Do not use this method anymore as it is deprecated.

+	
Note: Do not use this method any more as it is deprecated.

 
 	
Instead use specific event constructors, like {{domxref("CloseEvent.MouseEvent", "CloseEvent()")}}.
 		The page on Creating and triggering events gives more information about the way to use these.
diff --git a/files/en-us/web/api/cssstylesheet/index.html b/files/en-us/web/api/cssstylesheet/index.html
index 12be1b59bddcd61..fba228bf36ec169 100644
--- a/files/en-us/web/api/cssstylesheet/index.html
+++ b/files/en-us/web/api/cssstylesheet/index.html
@@ -45,7 +45,7 @@ 
Properties

 

  
{{domxref("CSSStyleSheet.cssRules")}}{{ReadOnlyInline}}

  
Returns a live {{domxref("CSSRuleList")}} which maintains an up-to-date list of the {{domxref("CSSRule")}} objects that comprise the stylesheet.
-    
Note: In some browsers, if a stylesheet is loaded from a different domain, accessing cssRules results in aSecurityError.

+    
Note: In some browsers, if a stylesheet is loaded from a different domain, accessing cssRules results in aSecurityError.

 
  

  
{{domxref("CSSStyleSheet.ownerRule")}}{{ReadOnlyInline}}

diff --git a/files/en-us/web/api/document/adoptnode/index.html b/files/en-us/web/api/document/adoptnode/index.html
index 81b6a91cb307420..9e4794520cc73d4 100644
--- a/files/en-us/web/api/document/adoptnode/index.html
+++ b/files/en-us/web/api/document/adoptnode/index.html
@@ -68,7 +68,7 @@ 
Notes

 
 
 

-  
Best Practice: Although Firefox doesn't currently enforce this rule,
+  
Note: Although Firefox doesn't currently enforce this rule,
     we encourage you to follow this rule for improved future compatibility.

 

 
diff --git a/files/en-us/web/api/document_object_model/index.html b/files/en-us/web/api/document_object_model/index.html
index 6b88b77f0044a5d..73d2b0a184db921 100644
--- a/files/en-us/web/api/document_object_model/index.html
+++ b/files/en-us/web/api/document_object_model/index.html
@@ -19,9 +19,8 @@
 
 
Nodes can also have event handlers attached to them. Once an event is triggered, the event handlers get executed.

 
-

-
To learn more about what the DOM is and how it represents documents, see our article Introduction to the DOM.

-

+
To learn more about what the DOM is and how it represents documents, see our article Introduction to the DOM.

+
 
 
DOM interfaces

 
diff --git a/files/en-us/web/api/element/mousewheel_event/index.html b/files/en-us/web/api/element/mousewheel_event/index.html
index 633405754e0baa7..a82b49fdaecae45 100644
--- a/files/en-us/web/api/element/mousewheel_event/index.html
+++ b/files/en-us/web/api/element/mousewheel_event/index.html
@@ -19,7 +19,7 @@
 
The obsolete and non-standard mousewheel event is fired asynchronously at an {{domxref("Element")}} to provide updates while a mouse wheel or similar device is operated. The mousewheel event was never part of any standard, and while it was implemented by several browsers, it was never implemented by Firefox.

 
 

-
Important: Instead of this obsolete event, use the standard {{domxref("Element.wheel_event", "wheel")}} event.

+
Note: Instead of this obsolete event, use the standard {{domxref("Element.wheel_event", "wheel")}} event.

 

 
 
diff --git a/files/en-us/web/api/element/mozmousepixelscroll_event/index.html b/files/en-us/web/api/element/mozmousepixelscroll_event/index.html
index 89a1167d140040c..7f9a9a1c3539701 100644
--- a/files/en-us/web/api/element/mozmousepixelscroll_event/index.html
+++ b/files/en-us/web/api/element/mozmousepixelscroll_event/index.html
@@ -21,7 +21,7 @@
 
The Firefox-only, non-standard, and obsolete MozMousePixelScroll event is fired at an {{domxref("Element")}} asynchronously when a mouse wheel or similar device is operated. It's represented by the {{ domxref("MouseScrollEvent") }} interface.

-
Important: Do not use this non-standard and obsolete event. Instead, you should always use the standard {{domxref("Element.wheel_event", "wheel")}} event.

+
Note: Do not use this non-standard and obsolete event. Instead, you should always use the standard {{domxref("Element.wheel_event", "wheel")}} event.

 

 
 
 
 

diff --git a/files/en-us/web/api/event/comparison_of_event_targets/index.html b/files/en-us/web/api/event/comparison_of_event_targets/index.html
index 2d2437913108eac..a82177b1ec36dde 100644
--- a/files/en-us/web/api/event/comparison_of_event_targets/index.html
+++ b/files/en-us/web/api/event/comparison_of_event_targets/index.html
@@ -67,11 +67,7 @@ 
Event targets
Use of explicitOriginalTarget and originalTarget

-
TODO: Only available in a Mozilla-based browser?

-

-
-

-
TODO: Only suitable for extension-developers?

+
Note: These properties are only available in Mozilla-based browsers.

 
Examples

diff --git a/files/en-us/web/api/event/initevent/index.html b/files/en-us/web/api/event/initevent/index.html
index 4d71ae58d876eb2..38e89b54a069973 100644
--- a/files/en-us/web/api/event/initevent/index.html
+++ b/files/en-us/web/api/event/initevent/index.html
@@ -21,12 +21,10 @@
   before it is dispatched, using {{ domxref("EventTarget.dispatchEvent()") }}. Once
   dispatched, it doesn't do anything anymore.

 
-

   
Do not use this method anymore as it is deprecated.

 
   
Instead use specific event constructors, like {{domxref("Event.Event", "Event()")}}.
     The page on Creating and triggering events gives more information about the way to use these.

-
Syntax

 
diff --git a/files/en-us/web/api/ext_blend_minmax/index.html b/files/en-us/web/api/ext_blend_minmax/index.html
index 4b8ed8567b3d133..dfb5a1f7430cb04 100644
--- a/files/en-us/web/api/ext_blend_minmax/index.html
+++ b/files/en-us/web/api/ext_blend_minmax/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constants in WebGL2 are gl.MIN and gl.MAX.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constants in WebGL2 are gl.MIN and gl.MAX.

 
Constants

diff --git a/files/en-us/web/api/ext_color_buffer_float/index.html b/files/en-us/web/api/ext_color_buffer_float/index.html
index ca5ad1249a73b33..0b43ce22719de2a 100644
--- a/files/en-us/web/api/ext_color_buffer_float/index.html
+++ b/files/en-us/web/api/ext_color_buffer_float/index.html
@@ -16,7 +16,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

-
Availability: This extension is available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts only.

+
Note: This extension is available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts only.

 
 
For {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}}, see the {{domxref("EXT_color_buffer_half_float")}} and {{domxref("WEBGL_color_buffer_float")}} extensions.

 

diff --git a/files/en-us/web/api/ext_color_buffer_half_float/index.html b/files/en-us/web/api/ext_color_buffer_half_float/index.html
index 13d04cc6caae61b..263a4180e494b09 100644
--- a/files/en-us/web/api/ext_color_buffer_half_float/index.html
+++ b/files/en-us/web/api/ext_color_buffer_half_float/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts. On WebGL 2, it's an alternative to using the {{domxref("EXT_color_buffer_float")}} extension on platforms that support 16-bit floating point render targets but not 32-bit floating point render targets.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts. On WebGL 2, it's an alternative to using the {{domxref("EXT_color_buffer_float")}} extension on platforms that support 16-bit floating point render targets but not 32-bit floating point render targets.

 
 
The {{domxref("OES_texture_half_float")}} extension implicitly enables this extension.

 

diff --git a/files/en-us/web/api/ext_disjoint_timer_query/index.html b/files/en-us/web/api/ext_disjoint_timer_query/index.html
index 0d975de463bf0be..7972de6d488b096 100644
--- a/files/en-us/web/api/ext_disjoint_timer_query/index.html
+++ b/files/en-us/web/api/ext_disjoint_timer_query/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

-
Availability: This extension should be available in {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts only. {{domxref("EXT_disjoint_timer_query_webgl2")}} is available in {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts .

+
Note: This extension should be available in {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts only. {{domxref("EXT_disjoint_timer_query_webgl2")}} is available in {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts .

 
 
In WebGL 2, the {{domxref("getQueryObject")}} was renamed to {{domxref("getQueryParameter")}}.

  In WebGL 2, other queries (such as occlusion queries and primitive queries) are possible using {{domxref("WebGLQuery")}} objects.

diff --git a/files/en-us/web/api/ext_float_blend/index.html b/files/en-us/web/api/ext_float_blend/index.html
index d8d73d5317994b6..ada2d7f7684746c 100644
--- a/files/en-us/web/api/ext_float_blend/index.html
+++ b/files/en-us/web/api/ext_float_blend/index.html
@@ -22,7 +22,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts. However, to use it, you need to enable the use of 32-bit floating-point draw buffers by  enabling the extension {{domxref("WEBGL_color_buffer_float")}} (for WebGL1) or {{domxref("EXT_color_buffer_float")}} (for WebGL2). Doing so automatically enables EXT_float_blend as well.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts. However, to use it, you need to enable the use of 32-bit floating-point draw buffers by  enabling the extension {{domxref("WEBGL_color_buffer_float")}} (for WebGL1) or {{domxref("EXT_color_buffer_float")}} (for WebGL2). Doing so automatically enables EXT_float_blend as well.

 

 
 
With this extension enabled, calling {{domxref("WebGLRenderingContext.drawArrays", "drawArrays()")}} or {{domxref("WebGLRenderingContext.drawElements", "drawElements()")}} with blending enabled and a draw buffer with 32-bit floating-point components will no longer result in an INVALID_OPERATION error.

diff --git a/files/en-us/web/api/ext_frag_depth/index.html b/files/en-us/web/api/ext_frag_depth/index.html
index 326fc83de9f3d05..64fb953b2056f9c 100644
--- a/files/en-us/web/api/ext_frag_depth/index.html
+++ b/files/en-us/web/api/ext_frag_depth/index.html
@@ -16,7 +16,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. It requires GLSL #version 300 es.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. It requires GLSL #version 300 es.

 

 
 
Examples

diff --git a/files/en-us/web/api/ext_shader_texture_lod/index.html b/files/en-us/web/api/ext_shader_texture_lod/index.html
index 505fba6788eb052..8a190f850479128 100644
--- a/files/en-us/web/api/ext_shader_texture_lod/index.html
+++ b/files/en-us/web/api/ext_shader_texture_lod/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. It requires GLSL #version 300 es.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. It requires GLSL #version 300 es.

 

 
 
GLSL built-in functions

diff --git a/files/en-us/web/api/ext_srgb/index.html b/files/en-us/web/api/ext_srgb/index.html
index 36e872fc0ec8604..d608887b5109e9c 100644
--- a/files/en-us/web/api/ext_srgb/index.html
+++ b/files/en-us/web/api/ext_srgb/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constants in WebGL2 are: gl.SRGB, gl.SRGB8, gl.SRGB8_ALPHA8 and gl.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constants in WebGL2 are: gl.SRGB, gl.SRGB8, gl.SRGB8_ALPHA8 and gl.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING.

 

 
 
Constants

diff --git a/files/en-us/web/api/ext_texture_compression_bptc/index.html b/files/en-us/web/api/ext_texture_compression_bptc/index.html
index 52d99c077fc20d2..c07cf65424c96a6 100644
--- a/files/en-us/web/api/ext_texture_compression_bptc/index.html
+++ b/files/en-us/web/api/ext_texture_compression_bptc/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: Support depends on the system's graphics driver. There is no support on Windows.

+
Note: Support depends on the system's graphics driver. There is no support on Windows.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

diff --git a/files/en-us/web/api/ext_texture_compression_rgtc/index.html b/files/en-us/web/api/ext_texture_compression_rgtc/index.html
index f20fd58b24d302b..cf23834392d1133 100644
--- a/files/en-us/web/api/ext_texture_compression_rgtc/index.html
+++ b/files/en-us/web/api/ext_texture_compression_rgtc/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: Support depends on the system's graphics driver. There is no support on Windows.

+
Note: Support depends on the system's graphics driver. There is no support on Windows.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

diff --git a/files/en-us/web/api/ext_texture_filter_anisotropic/index.html b/files/en-us/web/api/ext_texture_filter_anisotropic/index.html
index e4c3824c2276d62..7c3d219de96d5bf 100644
--- a/files/en-us/web/api/ext_texture_filter_anisotropic/index.html
+++ b/files/en-us/web/api/ext_texture_filter_anisotropic/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/ext_texture_norm16/index.html b/files/en-us/web/api/ext_texture_norm16/index.html
index 43ab75357b0b1c4..d43875edddceb01 100644
--- a/files/en-us/web/api/ext_texture_norm16/index.html
+++ b/files/en-us/web/api/ext_texture_norm16/index.html
@@ -21,7 +21,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts.

+
Note: This extension is only available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/filereader/readasarraybuffer/index.html b/files/en-us/web/api/filereader/readasarraybuffer/index.html
index 95ad6d8ed750269..4abc31046fc728c 100644
--- a/files/en-us/web/api/filereader/readasarraybuffer/index.html
+++ b/files/en-us/web/api/filereader/readasarraybuffer/index.html
@@ -23,8 +23,7 @@
   contains an {{jsxref("ArrayBuffer")}} representing the file's data.

 
 

-  
Newer API available

-    The {{domxref("Blob.arrayBuffer()")}} method is a newer promise-based API to read a
+  
Note: The {{domxref("Blob.arrayBuffer()")}} method is a newer promise-based API to read a
     file as an array buffer.

 

 
diff --git a/files/en-us/web/api/filereader/readastext/index.html b/files/en-us/web/api/filereader/readastext/index.html
index 2732ca6e808aa9c..3387698f6890062 100644
--- a/files/en-us/web/api/filereader/readastext/index.html
+++ b/files/en-us/web/api/filereader/readastext/index.html
@@ -19,8 +19,7 @@
   a text string.

 
 

-  
Newer API available

-    The {{domxref("Blob.text()")}} method is a newer promise-based API to read a file as
+  
Note: The {{domxref("Blob.text()")}} method is a newer promise-based API to read a file as
     text.

 

 
diff --git a/files/en-us/web/api/globaleventhandlers/onmousewheel/index.html b/files/en-us/web/api/globaleventhandlers/onmousewheel/index.html
index cc0c6879f63e5b0..4eb744235325207 100644
--- a/files/en-us/web/api/globaleventhandlers/onmousewheel/index.html
+++ b/files/en-us/web/api/globaleventhandlers/onmousewheel/index.html
@@ -11,11 +11,7 @@
         href="/en-US/docs/Web/Guide/Events/Event_handlers">event handler for the
     {{event("mousewheel")}} event.

 
-

-    
Do not use this wheel event. This interface is non-standard and
-        deprecated. It was used in non-Gecko browsers only. Instead use the standard
-        {{event("wheel")}} event.

-

+
Instead of using this event, use the standard {{event("wheel")}} event.

 
 
Syntax

 
diff --git a/files/en-us/web/api/htmlelement/dataset/index.html b/files/en-us/web/api/htmlelement/dataset/index.html
index 5135ee38d44d1bd..0c41069267c9724 100644
--- a/files/en-us/web/api/htmlelement/dataset/index.html
+++ b/files/en-us/web/api/htmlelement/dataset/index.html
@@ -16,11 +16,11 @@
 
The dataset read-only property
 of the {{DOMxRef("HTMLElement")}} interface provides read/write access to custom data attributes
-(data-*) on elements. It exposes a map of strings
+(data-*) on elements. It exposes a map of strings
 ({{domxref("DOMStringMap")}}) with an entry for each data-* attribute.

 
 

-  
The dataset property itself can be read, but not directly written.
+  
Note: The dataset property itself can be read, but not directly written.
     Instead, all writes must be to the individual properties within the
     dataset, which in turn represent the data attributes.

 

@@ -99,10 +99,8 @@ 
Setting values

 
 
    
   
  • When the attribute is set, its value is always converted to a string.
-    
    
-      
    For example: element.dataset.example = null is
+      
    For example: element.dataset.example = null is
         converted into data-example="null".
    
-    
    
   
    • 
   
  • To remove an attribute, you can use the delete
diff --git a/files/en-us/web/api/htmlelement/offsetparent/index.html b/files/en-us/web/api/htmlelement/offsetparent/index.html
index 0bad12367608a5e..de8b0c6a3d299c5 100644
--- a/files/en-us/web/api/htmlelement/offsetparent/index.html
+++ b/files/en-us/web/api/htmlelement/offsetparent/index.html
@@ -18,10 +18,8 @@
   body if there are no ancestor table elements either.
    
 
 
    
-  
    NOTE: 
    
-
-  
    offsetParent returns null in the following
-      situations:
    
+  
    Note: offsetParent returns null in the following
+      situations:
    
 
   
      
     
    • The element or its parent element has the display property set to
diff --git a/files/en-us/web/api/htmlimageelement/image/index.html b/files/en-us/web/api/htmlimageelement/image/index.html
index 9d19d46eec573d3..8ceb211a4392546 100644
--- a/files/en-us/web/api/htmlimageelement/image/index.html
+++ b/files/en-us/web/api/htmlimageelement/image/index.html
@@ -21,9 +21,8 @@
     "document.createElement('img')")}}.
      
 
 
      
-  
      Disambiguation: image(), the CSS function
-      notation.
      
+  
      Note: This function should not be confused with the CSS image() function.
      
 
      
 
 
      Syntax
      
diff --git a/files/en-us/web/api/keyboardevent/charcode/index.html b/files/en-us/web/api/keyboardevent/charcode/index.html
index 13e86da016b5efd..e626f86752ab1d8 100644
--- a/files/en-us/web/api/keyboardevent/charcode/index.html
+++ b/files/en-us/web/api/keyboardevent/charcode/index.html
@@ -16,8 +16,8 @@
   {{domxref("KeyboardEvent")}} interface returns the Unicode value of a character key
   pressed during a {{Event("keypress")}} event.
      
 
-
      
-  
      Do not use this property, as it is deprecated. Instead, get the
+
      
+  
      Warning: Do not use this property, as it is deprecated. Instead, get the
     Unicode value of the character using the {{domxref("KeyboardEvent.key", "key")}}
     property.
      
 
      
diff --git a/files/en-us/web/api/keyboardevent/initkeyevent/index.html b/files/en-us/web/api/keyboardevent/initkeyevent/index.html
index 14442d74c9de697..540c14772efe361 100644
--- a/files/en-us/web/api/keyboardevent/initkeyevent/index.html
+++ b/files/en-us/web/api/keyboardevent/initkeyevent/index.html
@@ -19,14 +19,14 @@
   initKeyEvent() must be called to set the event before it is dispatched.
      
 
-
      
-  
      Do not use this method anymore, use the
+
      
+  
      Warning: Do not use this method. Use the
       {{domxref("KeyboardEvent.KeyboardEvent", "KeyboardEvent()")}} constructor
-      instead.
      
+      instead.
      
     
      
     This method is based on the key events spec in the early versions
-    of DOM 2 Events, later removed from that spec.Favor the modern constructor structure as
+    of DOM 2 Events, later removed from that spec. Prefer the modern constructor structure as
     the only cross-browser way of building events.
   
      
 
      
diff --git a/files/en-us/web/api/mousescrollevent/index.html b/files/en-us/web/api/mousescrollevent/index.html
index e640158e142d2eb..0e197ab86f7d741 100644
--- a/files/en-us/web/api/mousescrollevent/index.html
+++ b/files/en-us/web/api/mousescrollevent/index.html
@@ -15,8 +15,8 @@
 
 
      The MouseScrollEvent interface represents events that occur due to the user moving a mouse wheel or similar input device.
      
 
-
      
-
      Do not use this interface for wheel events.
      
+
      
+
      Warning: Do not use this interface for wheel events.
      
 
 
      Like {{domxref("MouseWheelEvent")}}, this interface is non-standard and deprecated. It was used in Gecko-based browsers only. Instead use the standard {{domxref("WheelEvent")}}.
      
 
      
diff --git a/files/en-us/web/api/mousewheelevent/index.html b/files/en-us/web/api/mousewheelevent/index.html
index e81f2de16ed2a4a..a0460a13d213287 100644
--- a/files/en-us/web/api/mousewheelevent/index.html
+++ b/files/en-us/web/api/mousewheelevent/index.html
@@ -13,8 +13,8 @@
 
 
      The MouseWheelEvent interface represents events that occur due to the user turning a mouse wheel.
      
 
-
      
-
      Do not use this interface for wheel events.
      
+
      
+
      Warning: Do not use this interface for wheel events.
      
 
 
      Like {{domxref("MouseScrollEvent")}}, this interface is non-standard and deprecated. It was used in non-Gecko browsers only. Instead use the standard {{domxref("WheelEvent")}}.
      
 
      
diff --git a/files/en-us/web/api/navigation_timing_api/index.html b/files/en-us/web/api/navigation_timing_api/index.html
index e0fc08d201704e7..c9f41f6328fc8a4 100644
--- a/files/en-us/web/api/navigation_timing_api/index.html
+++ b/files/en-us/web/api/navigation_timing_api/index.html
@@ -17,7 +17,7 @@
 
      The Navigation Timing API provides data that can be used to measure the performance of a web site. Unlike JavaScript-based libraries that have historically been used to collect similar information, the Navigation Timing API can be much more accurate and reliable.
      
 
 
      
-
      This article currently describes Navigation Timing Level 1. There is a specification for Level 2, but it is not yet covered here.
      
+
      Note: This article currently describes Navigation Timing Level 1. There is a specification for Level 2, but it is not yet covered here.
      
 
      
 
 
      Concepts and usage
      
diff --git a/files/en-us/web/api/node/appendchild/index.html b/files/en-us/web/api/node/appendchild/index.html
index bb14a2fa4290b0b..150c19b3248e84e 100644
--- a/files/en-us/web/api/node/appendchild/index.html
+++ b/files/en-us/web/api/node/appendchild/index.html
@@ -28,8 +28,7 @@
   node.
      
 
 
      
-  
      Newer API available!
      
-    The {{domxref("Element.append()")}} method supports multiple arguments and
+  
      Note: The {{domxref("Element.append()")}} method supports multiple arguments and
     appending strings.
      
 
      
 
diff --git a/files/en-us/web/api/oes_element_index_uint/index.html b/files/en-us/web/api/oes_element_index_uint/index.html
index ab2f4891b76eabc..6f663fb4fb9ceb0 100644
--- a/files/en-us/web/api/oes_element_index_uint/index.html
+++ b/files/en-us/web/api/oes_element_index_uint/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default.
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default.
      
 
      
 
 
      Extended methods
      
diff --git a/files/en-us/web/api/oes_fbo_render_mipmap/index.html b/files/en-us/web/api/oes_fbo_render_mipmap/index.html
index 3728ef5e6f24d44..356378dda5cf2b8 100644
--- a/files/en-us/web/api/oes_fbo_render_mipmap/index.html
+++ b/files/en-us/web/api/oes_fbo_render_mipmap/index.html
@@ -16,7 +16,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}}.  
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}}.  
      
  In WebGL2, the functionality of this extension is available in the WebGL 2 context by default.
      
 
      
 
diff --git a/files/en-us/web/api/oes_standard_derivatives/index.html b/files/en-us/web/api/oes_standard_derivatives/index.html
index 07ad0e04106e9c3..0c14531c3bfbcda 100644
--- a/files/en-us/web/api/oes_standard_derivatives/index.html
+++ b/files/en-us/web/api/oes_standard_derivatives/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. In WebGL 2, the constant is available as gl.FRAGMENT_SHADER_DERIVATIVE_HINT and it requires GLSL #version 300 es.
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. In WebGL 2, the constant is available as gl.FRAGMENT_SHADER_DERIVATIVE_HINT and it requires GLSL #version 300 es.
      
 
      
 
 
      Constants
      
diff --git a/files/en-us/web/api/oes_texture_float/index.html b/files/en-us/web/api/oes_texture_float/index.html
index 1f8a773c329f40d..0b78f609eaed172 100644
--- a/files/en-us/web/api/oes_texture_float/index.html
+++ b/files/en-us/web/api/oes_texture_float/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default.
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default.
      
 
      
 
 
      Extended methods
      
diff --git a/files/en-us/web/api/oes_texture_float_linear/index.html b/files/en-us/web/api/oes_texture_float_linear/index.html
index f946e668c44b498..063bf27c454857f 100644
--- a/files/en-us/web/api/oes_texture_float_linear/index.html
+++ b/files/en-us/web/api/oes_texture_float_linear/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.
      
+
      Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.
      
 
      
 
 
      Linear filtering
      
diff --git a/files/en-us/web/api/oes_texture_half_float/index.html b/files/en-us/web/api/oes_texture_half_float/index.html
index b159c0f709ab828..c4c757eba6e8b2b 100644
--- a/files/en-us/web/api/oes_texture_half_float/index.html
+++ b/files/en-us/web/api/oes_texture_half_float/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constant in WebGL2 is gl.HALF_FLOAT.
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constant in WebGL2 is gl.HALF_FLOAT.
      
 
      
 
 
      Constants
      
diff --git a/files/en-us/web/api/oes_texture_half_float_linear/index.html b/files/en-us/web/api/oes_texture_half_float_linear/index.html
index 00fdf56da0a51b7..dd6265eb7adf349 100644
--- a/files/en-us/web/api/oes_texture_half_float_linear/index.html
+++ b/files/en-us/web/api/oes_texture_half_float_linear/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.
      
+
      Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.
      
 
      
 
 
      Linear filtering
      
diff --git a/files/en-us/web/api/oes_vertex_array_object/index.html b/files/en-us/web/api/oes_vertex_array_object/index.html
index 4a3ca1eeb0dcc17..db47d0b6836cb78 100644
--- a/files/en-us/web/api/oes_vertex_array_object/index.html
+++ b/files/en-us/web/api/oes_vertex_array_object/index.html
@@ -15,7 +15,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default and the constants and methods are available without the "OES" suffix.
      
+
      Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default and the constants and methods are available without the "OES" suffix.
      
 
      
 
 
      Constants
      
diff --git a/files/en-us/web/api/ovr_multiview2/index.html b/files/en-us/web/api/ovr_multiview2/index.html
index 2b0af5779bca960..db0c2cc63d41843 100644
--- a/files/en-us/web/api/ovr_multiview2/index.html
+++ b/files/en-us/web/api/ovr_multiview2/index.html
@@ -24,7 +24,7 @@
 
      WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.
      
 
 
      
-
      Availability: Support depends on the system's graphics driver (Windows+ANGLE and Android are supported; Windows+GL, Mac, Linux are not supported).
      
+
      Note: Support depends on the system's graphics driver (Windows+ANGLE and Android are supported; Windows+GL, Mac, Linux are not supported).
      
 
 
      This extension is only available to {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts as it needs GLSL 3.00 and texture arrays.
      
 
      
diff --git a/files/en-us/web/api/page_visibility_api/index.html b/files/en-us/web/api/page_visibility_api/index.html
index 3f59c3dd5438e7a..a1649690e6ca3cf 100644
--- a/files/en-us/web/api/page_visibility_api/index.html
+++ b/files/en-us/web/api/page_visibility_api/index.html
@@ -20,7 +20,7 @@
 
      The Page Visibility API provides events you can watch for to know when a document becomes visible or hidden, as well as features to look at the current visibility state of the page.
      
 
 
      
-
      Notes: The Page Visibility API is especially useful for saving resources and improving performance by letting a page avoid performing unnecessary tasks when the document isn't visible.
      
+
      Note: The Page Visibility API is especially useful for saving resources and improving performance by letting a page avoid performing unnecessary tasks when the document isn't visible.
      
 
      
 
 
      When the user minimizes the window or switches to another tab, the API sends a {{event("visibilitychange")}} event to let listeners know the state of the page has changed. You can detect the event and perform some actions or behave differently. For example, if your web app is playing a video, it can pause the video when the user puts the tab into the background, and resume playback when the user returns to the tab. The user doesn't lose their place in the video, the video's soundtrack doesn't interfere with audio in the new foreground tab, and the user doesn't miss any of the video in the meantime.
      
diff --git a/files/en-us/web/api/paymentcurrencyamount/value/index.html b/files/en-us/web/api/paymentcurrencyamount/value/index.html
index 076c5d13fc7650c..c04973942650dee 100644
--- a/files/en-us/web/api/paymentcurrencyamount/value/index.html
+++ b/files/en-us/web/api/paymentcurrencyamount/value/index.html
@@ -30,7 +30,7 @@
   discount.
      
 
 
      
-  
      Important note: The number given in this string is always specified
+  
      Note: The number given in this string is always specified
     using the period (".") as the decimal point, rather than the comma (","), even if the
     user's locale normally uses the comma. You must convert the entered text to this form
     or it will not be valid.
      
diff --git a/files/en-us/web/api/pointer_events/index.html b/files/en-us/web/api/pointer_events/index.html
index e20fdb653eebae1..d5ca0b00bf2b441 100644
--- a/files/en-us/web/api/pointer_events/index.html
+++ b/files/en-us/web/api/pointer_events/index.html
@@ -346,7 +346,7 @@ 
      Determining button states
      
 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 
 

-
Notice: The button property indicates a change in the state of the button. However, as in the case of touch, when multiple events occur with one event, all of them have the same value.

+
Note: The button property indicates a change in the state of the button. However, as in the case of touch, when multiple events occur with one event, all of them have the same value.

 

 
 
Pointer capture

diff --git a/files/en-us/web/api/storagemanager/estimate/index.html b/files/en-us/web/api/storagemanager/estimate/index.html
index f849ac9abdc26ad..8481fcb5559d2c8 100644
--- a/files/en-us/web/api/storagemanager/estimate/index.html
+++ b/files/en-us/web/api/storagemanager/estimate/index.html
@@ -33,7 +33,7 @@ 
Return value

 
A {{jsxref('Promise')}} that resolves to an object which conforms to the {{domxref('StorageEstimate')}} dictionary. This dictionary contains estimates of how much space is available to the origin in {{domxref("StorageEstimate.quota")}}, as well as how much is currently used in {{domxref("StorageEstimate.usage")}}.

 
 

-
The returned values are not exact; between compression, deduplication, and obfuscation for security reasons, they will be imprecise.

+
Note: The returned values are not exact: between compression, deduplication, and obfuscation for security reasons, they will be imprecise.

 

 
 
You may find that the quota varies from origin to origin. This variance is based on factors such as:

diff --git a/files/en-us/web/api/svganimatedstring/animval/index.html b/files/en-us/web/api/svganimatedstring/animval/index.html
index b889691cd510463..e69ae49986f0a27 100644
--- a/files/en-us/web/api/svganimatedstring/animval/index.html
+++ b/files/en-us/web/api/svganimatedstring/animval/index.html
@@ -8,7 +8,7 @@
 
AnimVal attribute or animVal property contains the same value as the baseVal property.If the given attribute or property is being animated, contains the current animated value of the attribute or property. If the given attribute or property is not currently being animated, then it contains the same value as baseVal

 
 

-
The animVal property is a read only property. Internet Explorer 9 supports script-based SVG animation but it does not support declarative-based SVG animation. As a result, the animVal property contains the same value as the baseVal property.

+
Note: The animVal property is a read only property. Internet Explorer 9 supports script-based SVG animation but it does not support declarative-based SVG animation. As a result, the animVal property contains the same value as the baseVal property.

 

 
 
Syntax

diff --git a/files/en-us/web/api/uievent/inituievent/index.html b/files/en-us/web/api/uievent/inituievent/index.html
index 9dc9981f80dde35..6c0cac86114a7bb 100644
--- a/files/en-us/web/api/uievent/inituievent/index.html
+++ b/files/en-us/web/api/uievent/inituievent/index.html
@@ -20,8 +20,8 @@
   before it is dispatched, using {{ domxref("EventTarget.dispatchEvent()") }}. Once
   dispatched, it doesn't do anything anymore.

 
-

-  
Do not use this method anymore as it is deprecated.

+

+  
Warning: Do not use this method anymore as it is deprecated.

 
   
Instead use specific event constructors, like {{domxref("UIEvent.UIEvent",
     "UIEvent()")}}. The page on Creating and triggering events gives more information about the way to use these.

diff --git a/files/en-us/web/api/web_authentication_api/index.html b/files/en-us/web/api/web_authentication_api/index.html
index afcf5fb8cc1ee66..6e61c16f8e955fe 100644
--- a/files/en-us/web/api/web_authentication_api/index.html
+++ b/files/en-us/web/api/web_authentication_api/index.html
@@ -32,7 +32,7 @@ 
Web authentication concepts and u
 
 
 

-
Please note: Both create() and get() require a secure context (i.e. the server is connected by HTTPS or is the localhost), and will not be available for use if the browser is not operating in a secure context.

+
Note: Both create() and get() require a secure context (i.e. the server is connected by HTTPS or is the localhost), and will not be available for use if the browser is not operating in a secure context.

 

 
 
In their most basic forms, both create() and get() receive a very large random number called the "challenge" from the server and they return the challenge signed by the private key back to the server. This proves to the server that a user is in possession of the private key required for authentication without revealing any secrets over the network.

diff --git a/files/en-us/web/api/webgl_color_buffer_float/index.html b/files/en-us/web/api/webgl_color_buffer_float/index.html
index c351bb2f1123340..efe6562034402ca 100644
--- a/files/en-us/web/api/webgl_color_buffer_float/index.html
+++ b/files/en-us/web/api/webgl_color_buffer_float/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}} contexts only. For {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}}, use the {{domxref("EXT_color_buffer_float")}} extension.

+
Note: This extension is available to {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}} contexts only. For {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}}, use the {{domxref("EXT_color_buffer_float")}} extension.

 
 
The {{domxref("OES_texture_float")}} extension implicitly enables this extension.

 

diff --git a/files/en-us/web/api/webgl_compressed_texture_astc/index.html b/files/en-us/web/api/webgl_compressed_texture_astc/index.html
index c8de2c7c0a57dc4..a0abb5282b3e0d8 100644
--- a/files/en-us/web/api/webgl_compressed_texture_astc/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_astc/index.html
@@ -18,7 +18,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: ASTC compression is typically available on Mali ARM GPUs, Intel GPUs, and Nividia Tegra chips.

+
Note: ASTC compression is typically available on Mali ARM GPUs, Intel GPUs, and Nividia Tegra chips.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

diff --git a/files/en-us/web/api/webgl_compressed_texture_etc/index.html b/files/en-us/web/api/webgl_compressed_texture_etc/index.html
index c85c81b1169cf99..0531c19fb198bf8 100644
--- a/files/en-us/web/api/webgl_compressed_texture_etc/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_etc/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_compressed_texture_etc1/index.html b/files/en-us/web/api/webgl_compressed_texture_etc1/index.html
index f8440eb530ff411..70f24582222b71f 100644
--- a/files/en-us/web/api/webgl_compressed_texture_etc1/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_etc1/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_compressed_texture_pvrtc/index.html b/files/en-us/web/api/webgl_compressed_texture_pvrtc/index.html
index cbe654b81b1055d..f432ad3e404a18a 100644
--- a/files/en-us/web/api/webgl_compressed_texture_pvrtc/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_pvrtc/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: PVRTC is typically only available on mobile devices with PowerVR chipsets. It is used in all generations of the iPhone, iPod Touch and iPad and supported on certain Android devices that use a PowerVR GPU.

+
Note: PVRTC is typically only available on mobile devices with PowerVR chipsets. It is used in all generations of the iPhone, iPod Touch and iPad and supported on certain Android devices that use a PowerVR GPU.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 
diff --git a/files/en-us/web/api/webgl_compressed_texture_s3tc/index.html b/files/en-us/web/api/webgl_compressed_texture_s3tc/index.html
index 8258f032336d9a9..27fad49150dbabf 100644
--- a/files/en-us/web/api/webgl_compressed_texture_s3tc/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_s3tc/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_compressed_texture_s3tc_srgb/index.html b/files/en-us/web/api/webgl_compressed_texture_s3tc_srgb/index.html
index 65bf8058395921c..425246f31427aac 100644
--- a/files/en-us/web/api/webgl_compressed_texture_s3tc_srgb/index.html
+++ b/files/en-us/web/api/webgl_compressed_texture_s3tc_srgb/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_debug_renderer_info/index.html b/files/en-us/web/api/webgl_debug_renderer_info/index.html
index a6221b978595a6c..093c43e5cb63157 100644
--- a/files/en-us/web/api/webgl_debug_renderer_info/index.html
+++ b/files/en-us/web/api/webgl_debug_renderer_info/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: Depending on the privacy settings of the browser, this extension might only be available to privileged contexts or not work at all. In Firefox, if privacy.resistFingerprinting is set to true, this extensions is disabled.

+
Note: Depending on the privacy settings of the browser, this extension might only be available to privileged contexts or not work at all. In Firefox, if privacy.resistFingerprinting is set to true, this extensions is disabled.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

diff --git a/files/en-us/web/api/webgl_debug_shaders/index.html b/files/en-us/web/api/webgl_debug_shaders/index.html
index de33826cf873313..cd84a213a76d116 100644
--- a/files/en-us/web/api/webgl_debug_shaders/index.html
+++ b/files/en-us/web/api/webgl_debug_shaders/index.html
@@ -17,7 +17,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: Depending on the privacy settings of the browser, this extension might only be available to privileged contexts.

+
Note: Depending on the privacy settings of the browser, this extension might only be available to privileged contexts.

 
 
This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

diff --git a/files/en-us/web/api/webgl_depth_texture/index.html b/files/en-us/web/api/webgl_depth_texture/index.html
index ad1c88f00fbfca9..0e64ef6fdeeb826 100644
--- a/files/en-us/web/api/webgl_depth_texture/index.html
+++ b/files/en-us/web/api/webgl_depth_texture/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constant in WebGL2 is gl.UNSIGNED_INT_24_8.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. The constant in WebGL2 is gl.UNSIGNED_INT_24_8.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_draw_buffers/index.html b/files/en-us/web/api/webgl_draw_buffers/index.html
index ee5f270e2a3a0f5..16f585bc60abf6c 100644
--- a/files/en-us/web/api/webgl_draw_buffers/index.html
+++ b/files/en-us/web/api/webgl_draw_buffers/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. In WebGL 2, the constants are available without the "WEBGL" suffix and the new GLSL built-ins require GLSL #version 300 es.

+
Note: This extension is only available to {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} contexts. In {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}, the functionality of this extension is available on the WebGL2 context by default. In WebGL 2, the constants are available without the "WEBGL" suffix and the new GLSL built-ins require GLSL #version 300 es.

 

 
 
Constants

diff --git a/files/en-us/web/api/webgl_lose_context/index.html b/files/en-us/web/api/webgl_lose_context/index.html
index 78cce85304e0625..8c59342f7d3cb4e 100644
--- a/files/en-us/web/api/webgl_lose_context/index.html
+++ b/files/en-us/web/api/webgl_lose_context/index.html
@@ -15,7 +15,7 @@
 
WebGL extensions are available using the {{domxref("WebGLRenderingContext.getExtension()")}} method. For more information, see also Using Extensions in the WebGL tutorial.

 
 

-
Availability: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

+
Note: This extension is available to both, {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} and {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}} contexts.

 

 
 
Methods

diff --git a/files/en-us/web/api/webgl_multi_draw/index.html b/files/en-us/web/api/webgl_multi_draw/index.html
index 66f86a049197918..456b69f24948f60 100644
--- a/files/en-us/web/api/webgl_multi_draw/index.html
+++ b/files/en-us/web/api/webgl_multi_draw/index.html
@@ -23,7 +23,7 @@
 
 
 

-  
Availability: This extension is available to both,
+  
Note: This extension is available to both,
   {{domxref("WebGLRenderingContext", "WebGL 1", "", 1)}} and
   {{domxref("WebGL2RenderingContext", "WebGL 2", "", 1)}} contexts.

   
In shader code, the directive #extension GL_ANGLE_multi_draw
diff --git a/files/en-us/web/api/webglvertexarrayobject/index.html b/files/en-us/web/api/webglvertexarrayobject/index.html
index 465103bce509448..7482e9125830ecf 100644
--- a/files/en-us/web/api/webglvertexarrayobject/index.html
+++ b/files/en-us/web/api/webglvertexarrayobject/index.html
@@ -22,7 +22,7 @@
 
 
 

-
WebGL 1: The {{domxref("OES_vertex_array_object")}} extension allows you to use vertex array objects in a WebGL 1 context.

+
Note: The {{domxref("OES_vertex_array_object")}} extension allows you to use vertex array objects in a WebGL 1 context.

 

 
 
Examples

diff --git a/files/en-us/web/api/websockets_api/writing_websocket_servers/index.html b/files/en-us/web/api/websockets_api/writing_websocket_servers/index.html
index 8b988d5d84aa3e8..f4f439c56cb635a 100644
--- a/files/en-us/web/api/websockets_api/writing_websocket_servers/index.html
+++ b/files/en-us/web/api/websockets_api/writing_websocket_servers/index.html
@@ -37,7 +37,7 @@ 
The WebSocket handshake

 
The handshake is the "Web" in WebSockets. It's the bridge from HTTP to WebSockets. In the handshake, details of the connection are negotiated, and either party can back out before completion if the terms are unfavorable. The server must be careful to understand everything the client asks for, otherwise security issues can occur.

 
 

-
Tip: The request-uri (/chat here) has no defined meaning in the spec. So, many people  use it to let one server handle multiple WebSocket applications. For example, example.com/chat could invoke a multiuser chat app, while /game on the same server might invoke a multiplayer game.

+
Note: The request-uri (/chat here) has no defined meaning in the spec. So, many people  use it to let one server handle multiple WebSocket applications. For example, example.com/chat could invoke a multiuser chat app, while /game on the same server might invoke a multiplayer game.

 

 
 
Client handshake request

@@ -56,7 +56,7 @@ 
Client handshake request

 
The client can solicit extensions and/or subprotocols here; see Miscellaneous for details. Also, common headers like {{HTTPHeader("User-Agent")}}, {{HTTPHeader("Referer")}}, {{HTTPHeader("Cookie")}}, or authentication headers might be there as well. Do whatever you want with those; they don't directly pertain to the WebSocket. It's also safe to ignore them. In many common setups, a reverse proxy has already dealt with them.

 
 

-
Tip: All browsers send an Origin header. You can use this header for security (checking for same origin, automatically allowing or denying, etc.) and send a 403 Forbidden if you don't like what you see. However, be warned that non-browser agents can send a faked Origin. Most applications reject requests without this header.

+
Note: All browsers send an Origin header. You can use this header for security (checking for same origin, automatically allowing or denying, etc.) and send a 403 Forbidden if you don't like what you see. However, be warned that non-browser agents can send a faked Origin. Most applications reject requests without this header.

 

 
 
If any header is not understood or has an incorrect value, the server should send a {{HTTPStatus("400")}} ("Bad Request")} response and immediately close the socket. As usual, it may also give the reason why the handshake failed in the HTTP response body, but the message may never be displayed (browsers do not display it). If the server doesn't understand that version of WebSockets, it should send a {{HTTPHeader("Sec-WebSocket-Version")}} header back that contains the version(s) it does understand.  In the example above, it indicates version 13 of the WebSocket protocol.

@@ -176,7 +176,7 @@ 
Pings and Pongs: The Heartb
 
A ping or pong is just a regular frame, but it's a control frame. Pings have an opcode of 0x9, and pongs have an opcode of 0xA. When you get a ping, send back a pong with the exact same Payload Data as the ping (for pings and pongs, the max payload length is 125). You might also get a pong without ever sending a ping; ignore this if it happens.

 
 

-
If you have gotten more than one ping before you get the chance to send a pong, you only send one pong.

+
Note: If you have gotten more than one ping before you get the chance to send a pong, you only send one pong.

 

 
 
Closing the connection

@@ -186,31 +186,25 @@ 
Closing the connection

 
Miscellaneous

 
 

-
WebSocket codes, extensions, subprotocols, etc. are registered at the IANA WebSocket Protocol Registry.

+
Note: WebSocket codes, extensions, subprotocols, etc. are registered at the IANA WebSocket Protocol Registry.

 

 
 
WebSocket extensions and subprotocols are negotiated via headers during the handshake. Sometimes extensions and subprotocols very similar, but there is a clear distinction. Extensions control the WebSocket frame and modify the payload, while subprotocols structure the WebSocket payload and never modify anything. Extensions are optional and generalized (like compression); subprotocols are mandatory and localized (like ones for chat and for MMORPG games).

 
 
Extensions

 
-

-
This section needs expansion. Please edit if you are equipped to do so.

-

-
 
Think of an extension as compressing a file before e-mailing it to someone. Whatever you do, you're sending the same data in different forms. The recipient will eventually be able to get the same data as your local copy, but it is sent differently. That's what an extension does. WebSockets defines a protocol and a simple way to send data, but an extension such as compression could allow sending the same data but in a shorter format.

 
 

 
Extensions are explained in sections 5.8, 9, 11.3.2, and 11.4 of the spec.

 

 
-
TODO

-
 
Subprotocols

 
 
Think of a subprotocol as a custom XML schema or doctype declaration. You're still using XML and its syntax, but you're additionally restricted by a structure you agreed on. WebSocket subprotocols are just like that. They do not introduce anything fancy, they just establish structure. Like a doctype or schema, both parties must agree on the subprotocol; unlike a doctype or schema, the subprotocol is implemented on the server and cannot be externally referred to by the client.

 
 

-
Subprotocols are explained in sections 1.9, 4.2, 11.3.4, and 11.5 of the spec.

+
Note: Subprotocols are explained in sections 1.9, 4.2, 11.3.4, and 11.5 of the spec.

 

 
 
A client has to ask for a specific subprotocol. To do so, it will send something like this as part of the original handshake:

@@ -242,7 +236,7 @@ 
Subprotocols

 
If you want your server to obey certain subprotocols, then naturally you'll need extra code on the server. Let's imagine we're using a subprotocol json. In this subprotocol, all data is passed as JSON. If the client solicits this protocol and the server wants to use it, the server needs to have a JSON parser. Practically speaking, this will be part of a library, but the server needs to pass the data around.

 
 

-
Tip: To avoid name conflict, it's recommended to make your subprotocol name part of a domain string. If you are building a custom chat app that uses a proprietary format exclusive to Example Inc., then you might use this: Sec-WebSocket-Protocol: chat.example.com. Note that this isn't required, it's just an optional convention, and you can use any string you wish.

+
Note: To avoid name conflict, it's recommended to make your subprotocol name part of a domain string. If you are building a custom chat app that uses a proprietary format exclusive to Example Inc., then you might use this: Sec-WebSocket-Protocol: chat.example.com. Note that this isn't required, it's just an optional convention, and you can use any string you wish.

 

 
 
diff --git a/files/en-us/web/api/wheelevent/index.html b/files/en-us/web/api/wheelevent/index.html
index 3a8bf5f6a9f8741..70b57453d7aa938 100644
--- a/files/en-us/web/api/wheelevent/index.html
+++ b/files/en-us/web/api/wheelevent/index.html
@@ -14,11 +14,11 @@
 
The WheelEvent interface represents events that occur due to the user moving a mouse wheel or similar input device.

 
 

-
Important: This is the standard wheel event interface to use. Old versions of browsers implemented the non-standard and non-cross-browser-compatible {{DOMxRef("MouseWheelEvent")}} and {{DOMxRef("MouseScrollEvent")}} interfaces. Use this interface and avoid the non-standard ones.

+
Note: This is the standard wheel event interface to use. Old versions of browsers implemented the non-standard and non-cross-browser-compatible {{DOMxRef("MouseWheelEvent")}} and {{DOMxRef("MouseScrollEvent")}} interfaces. Use this interface and avoid the non-standard ones.

 

 
 

-
Do not confuse the {{domxref("Element/wheel_event", "wheel")}} event with the {{domxref("Element/scroll_event", "scroll")}} event: The default action of a wheel event is implementation-defined. Thus, a wheel event doesn't necessarily dispatch a scroll event. Even when it does, that doesn't mean that the delta* values in the wheel event necessarily reflect the content's scrolling direction. Therefore, do not rely on delta* properties to get the content's scrolling direction. Instead, detect value changes to {{DOMxRef("Element.scrollLeft", "scrollLeft")}} and {{DOMxRef("Element.scrollTop", "scrollTop")}} of the target in the scroll event.

+
Note: Do not confuse the {{domxref("Element/wheel_event", "wheel")}} event with the {{domxref("Element/scroll_event", "scroll")}} event. The default action of a wheel event is implementation-defined. Thus, a wheel event doesn't necessarily dispatch a scroll event. Even when it does, that doesn't mean that the delta* values in the wheel event necessarily reflect the content's scrolling direction. Therefore, do not rely on delta* properties to get the content's scrolling direction. Instead, detect value changes to {{DOMxRef("Element.scrollLeft", "scrollLeft")}} and {{DOMxRef("Element.scrollTop", "scrollTop")}} of the target in the scroll event.

 

 
 
{{InheritanceDiagram}}

diff --git a/files/en-us/web/api/window/open/index.html b/files/en-us/web/api/window/open/index.html
index 4be4eb2ea0f281e..0d48aa6265b3d58 100644
--- a/files/en-us/web/api/window/open/index.html
+++ b/files/en-us/web/api/window/open/index.html
@@ -21,7 +21,7 @@
   resource is loaded into it.

 
 

-   
Note that for brevity, this document will generally use the term "window" as a
+   
Note: For brevity, this document will generally use the term "window" as a
    shorthand for "a browsing context in a tab or window".

 

 
@@ -112,9 +112,8 @@ 
Examples

   special value _blank for windowName.

 
 

-  
Note on the use of window.open() to
-    reopen an existing window with name windowName : This
-    functionality is not valid for all browsers and more with variable conditions.
+  
Note: The use of window.open() to
+    reopen an existing window with name windowName is not valid for all browsers and more with variable conditions.
     Firefox (50.0.1) functions as described: from the same domain+port reopen with same
       name will access the previously created window. Google Chrome (55.0.2883.87 m )
     on the other hand will do it only from the same parent (as if the window was created
@@ -139,7 +138,7 @@ 
Window features

   main window.

 
 

-  
Tip: Note that in some browsers, users can override the
+  
Note: In some browsers, users can override the
     windowFeatures settings and enable (or prevent the disabling
     of) features. Further, control of some window features is available only on some browsers
     and platforms (See popup condition section)
@@ -276,7 +275,7 @@ 
Toolbar and UI parts features

     If windowFeatures is non-empty, resizable
     defaults to on.
     

-      
Tip: For accessibility reasons, it is strongly recommended to
+      
Note: For accessibility reasons, it is strongly recommended to
         set this feature always on

     

   
@@ -289,8 +288,8 @@ 
Toolbar and UI parts features

     

     See note on scrollbars.
     

-      
Tip: For accessibility reasons, it is strongly encouraged to set
-        this feature always on

+      
Note: For accessibility reasons, it is strongly encouraged to set
+        this feature always on.