From 702ed44c68b497912b8a79416842f043b3822cc6 Mon Sep 17 00:00:00 2001 From: Will Bamberg Date: Wed, 1 Sep 2021 16:19:23 -0700 Subject: [PATCH 1/2] Ensure Note: is followed by a space --- .../web/api/analysernode/smoothingtimeconstant/index.html | 2 +- files/en-us/web/api/audioworkletprocessor/process/index.html | 2 +- files/en-us/web/api/cache/addall/index.html | 2 +- files/en-us/web/api/cookiestore/delete/index.html | 2 +- files/en-us/web/api/cookiestore/get/index.html | 2 +- files/en-us/web/api/cookiestore/getall/index.html | 2 +- files/en-us/web/api/css_font_loading_api/index.html | 2 +- files/en-us/web/api/domparser/index.html | 5 ++--- files/en-us/web/api/element/setpointercapture/index.html | 2 +- files/en-us/web/api/file/getasbinary/index.html | 2 +- files/en-us/web/api/file/getastext/index.html | 2 +- files/en-us/web/api/htmlimageelement/ismap/index.html | 2 +- files/en-us/web/api/idbcursor/index.html | 2 +- files/en-us/web/api/indexeddb_api/using_indexeddb/index.html | 2 +- .../using_the_media_capabilities_api/index.html | 2 +- .../web-based_protocol_handlers/index.html | 4 ++-- files/en-us/web/api/notification/close/index.html | 2 +- files/en-us/web/api/permissions_api/index.html | 2 +- files/en-us/web/api/pointer_events/index.html | 2 +- .../allowcredentials/index.html | 3 +-- files/en-us/web/api/remote_playback_api/index.html | 2 +- files/en-us/web/api/touchevent/index.html | 5 +---- .../using_the_web_animations_api/index.html | 2 +- .../web/api/web_audio_api/advanced_techniques/index.html | 2 +- .../basic_concepts_behind_web_audio_api/index.html | 4 ++-- .../web/api/web_audio_api/using_audioworklet/index.html | 2 +- files/en-us/web/api/web_workers_api/index.html | 2 +- .../api/webrtc_api/signaling_and_video_calling/index.html | 2 +- files/en-us/web/api/webvr_api/concepts/index.html | 2 +- files/en-us/web/api/webvr_api/index.html | 2 +- files/en-us/web/api/wheelevent/index.html | 2 +- files/en-us/web/api/window/defaultstatus/index.html | 2 +- 32 files changed, 35 insertions(+), 40 deletions(-) diff --git a/files/en-us/web/api/analysernode/smoothingtimeconstant/index.html b/files/en-us/web/api/analysernode/smoothingtimeconstant/index.html index 064ce1b626c98b9..e06d57f5ca5b659 100644 --- a/files/en-us/web/api/analysernode/smoothingtimeconstant/index.html +++ b/files/en-us/web/api/analysernode/smoothingtimeconstant/index.html @@ -29,7 +29,7 @@

Value

In technical terms, we apply a Blackman window and smooth the values over time. The default value is good enough for most cases.

-

Note:  If a value outside the range 0–1 is set, an INDEX_SIZE_ERR exception is thrown.

+

Note: If a value outside the range 0–1 is set, an INDEX_SIZE_ERR exception is thrown.

Example

diff --git a/files/en-us/web/api/audioworkletprocessor/process/index.html b/files/en-us/web/api/audioworkletprocessor/process/index.html index 2c8a6d209f1631b..d312d307ab1be3a 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.

-

Note: 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/cache/addall/index.html b/files/en-us/web/api/cache/addall/index.html index 187c7aa39a504e9..0c257ec9186ebe6 100644 --- a/files/en-us/web/api/cache/addall/index.html +++ b/files/en-us/web/api/cache/addall/index.html @@ -22,7 +22,7 @@ retrieval become keys to the stored response operations. 

-

Note: addAll() will overwrite any key/value pairs +

Note: addAll() will overwrite any key/value pairs previously stored in the cache that match the request, but will fail if a resulting put() operation would overwrite a previous cache entry stored by the same addAll() method.

diff --git a/files/en-us/web/api/cookiestore/delete/index.html b/files/en-us/web/api/cookiestore/delete/index.html index 2ad4cb49d9f7198..21a5956b4576c29 100644 --- a/files/en-us/web/api/cookiestore/delete/index.html +++ b/files/en-us/web/api/cookiestore/delete/index.html @@ -39,7 +39,7 @@

Parameters

-

Note:The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

+

Note: The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

Return value

diff --git a/files/en-us/web/api/cookiestore/get/index.html b/files/en-us/web/api/cookiestore/get/index.html index 1f456a4ae0c8d4d..0bc2874f261a2e7 100644 --- a/files/en-us/web/api/cookiestore/get/index.html +++ b/files/en-us/web/api/cookiestore/get/index.html @@ -37,7 +37,7 @@

Parameters

-

Note:The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

+

Note: The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

Return value

diff --git a/files/en-us/web/api/cookiestore/getall/index.html b/files/en-us/web/api/cookiestore/getall/index.html index 72bf53b245f8d6e..8f7c7af24ea8b70 100644 --- a/files/en-us/web/api/cookiestore/getall/index.html +++ b/files/en-us/web/api/cookiestore/getall/index.html @@ -35,7 +35,7 @@

Parameters

-

Note:The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

+

Note: The url option enables the modification of a cookie scoped under a particular URL. Service workers can obtain cookies that would be sent to any URL under their scope. From a document you may only obtain the cookies at the current URL, so the only valid URL in a document context is the document's URL.

Return value

diff --git a/files/en-us/web/api/css_font_loading_api/index.html b/files/en-us/web/api/css_font_loading_api/index.html index 439aefb6a198e86..4b7cf9987f547fa 100644 --- a/files/en-us/web/api/css_font_loading_api/index.html +++ b/files/en-us/web/api/css_font_loading_api/index.html @@ -15,7 +15,7 @@

The CSS Font Loading API provides events and interfaces for dynamically loading font resources.

-

Note: This feature is available in Web Workers (self.fonts provides access to {{domxref('FontFaceSet')}}).

+

Note: This feature is available in Web Workers (self.fonts provides access to {{domxref('FontFaceSet')}}).

Interfaces

diff --git a/files/en-us/web/api/domparser/index.html b/files/en-us/web/api/domparser/index.html index 04493da4d0ccbc6..2a0dcd73c5f942f 100644 --- a/files/en-us/web/api/domparser/index.html +++ b/files/en-us/web/api/domparser/index.html @@ -31,9 +31,8 @@ {{domxref("XMLHttpRequest.response", "response")}} property.

-

- Note: Be aware that block-level elements - like <p> will be automatically closed if another +

Note: Be aware that block-level elements + like <p> will be automatically closed if another block-level element is nested inside and therefore parsed before the closing </p> tag.

diff --git a/files/en-us/web/api/element/setpointercapture/index.html b/files/en-us/web/api/element/setpointercapture/index.html index 0e5d23dd547ff95..5097c5ea336f0fc 100644 --- a/files/en-us/web/api/element/setpointercapture/index.html +++ b/files/en-us/web/api/element/setpointercapture/index.html @@ -65,7 +65,7 @@

Exceptions

NotFoundError pointerId does not match any of the active pointers. -

Note: Firefox versions before Firefox +

Note: Firefox versions before Firefox 82 incorrectly throw InvalidPointerId.

diff --git a/files/en-us/web/api/file/getasbinary/index.html b/files/en-us/web/api/file/getasbinary/index.html index d0e9718901d574c..9700c9f0ae52590 100644 --- a/files/en-us/web/api/file/getasbinary/index.html +++ b/files/en-us/web/api/file/getasbinary/index.html @@ -13,7 +13,7 @@

{{APIRef("File API")}}{{non-standard_header}}{{deprecated_header}}

-

Note:This method was removed from Firefox 7.0 and onward.

+

Note: This method was removed from Firefox 7.0 and onward.

Summary

diff --git a/files/en-us/web/api/file/getastext/index.html b/files/en-us/web/api/file/getastext/index.html index eccb38b8b8bbd5b..231017be12845f8 100644 --- a/files/en-us/web/api/file/getastext/index.html +++ b/files/en-us/web/api/file/getastext/index.html @@ -13,7 +13,7 @@
{{APIRef("File API")}}{{non-standard_header}}{{deprecated_header}}
-

Note:This method was removed from Firefox 7.0 and onward.

+

Note: This method was removed from Firefox 7.0 and onward.

Summary

diff --git a/files/en-us/web/api/htmlimageelement/ismap/index.html b/files/en-us/web/api/htmlimageelement/ismap/index.html index ea40a8de56c1b29..1c00c8f287fac44 100644 --- a/files/en-us/web/api/htmlimageelement/ismap/index.html +++ b/files/en-us/web/api/htmlimageelement/ismap/index.html @@ -20,7 +20,7 @@ This may only be used on images located within an {{HTMLElement("a")}} element.

-

Note: For accessibility reasons, you should generally avoid using +

Note: For accessibility reasons, you should generally avoid using server-side image maps, as they require the use of a mouse. Use a client-side image map instead.

diff --git a/files/en-us/web/api/idbcursor/index.html b/files/en-us/web/api/idbcursor/index.html index 104d25b6f30b9b8..3993f5cc5637896 100644 --- a/files/en-us/web/api/idbcursor/index.html +++ b/files/en-us/web/api/idbcursor/index.html @@ -27,7 +27,7 @@

Properties

-

Note: {{domxref("IDBCursorWithValue")}} is an IDBCursor interface with an additional value property.

+

Note: {{domxref("IDBCursorWithValue")}} is an IDBCursor interface with an additional value property.

diff --git a/files/en-us/web/api/indexeddb_api/using_indexeddb/index.html b/files/en-us/web/api/indexeddb_api/using_indexeddb/index.html index efcfde4c936be88..fa0d1415f34ef94 100644 --- a/files/en-us/web/api/indexeddb_api/using_indexeddb/index.html +++ b/files/en-us/web/api/indexeddb_api/using_indexeddb/index.html @@ -1307,7 +1307,7 @@

JavaScript Content

{{ LiveSampleLink('Full_IndexedDB_example', "Test the online live demo") }}

-

Note: window.indexedDB.open() is asynchronous; the method will finish running long before the success event is fired. This means that a function (e.g. openDb()) that calls open() and onsuccess will return before the onsuccess handler has run. This issue is also true of other request methods such as transaction() and get().

+

Note: window.indexedDB.open() is asynchronous; the method will finish running long before the success event is fired. This means that a function (e.g. openDb()) that calls open() and onsuccess will return before the onsuccess handler has run. This issue is also true of other request methods such as transaction() and get().

See also

diff --git a/files/en-us/web/api/media_capabilities_api/using_the_media_capabilities_api/index.html b/files/en-us/web/api/media_capabilities_api/using_the_media_capabilities_api/index.html index 48be1854a2eb28c..759332fbddb738d 100644 --- a/files/en-us/web/api/media_capabilities_api/using_the_media_capabilities_api/index.html +++ b/files/en-us/web/api/media_capabilities_api/using_the_media_capabilities_api/index.html @@ -25,7 +25,7 @@
-

Note: The display capabilities functionality mentioned in the third point above have not yet appeared in any browser. They will be a useful feature of the API once available, but there is a high probability of the display capabilities functionality changing a great deal before browser implementations arrive.

+

Note: The display capabilities functionality mentioned in the third point above have not yet appeared in any browser. They will be a useful feature of the API once available, but there is a high probability of the display capabilities functionality changing a great deal before browser implementations arrive.

The MediaCapabilities interface

diff --git a/files/en-us/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html b/files/en-us/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html index a29e5d0fd792e6c..b3c63468b0263a9 100644 --- a/files/en-us/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html +++ b/files/en-us/web/api/navigator/registerprotocolhandler/web-based_protocol_handlers/index.html @@ -37,7 +37,7 @@

Registering

-

Note:The URL template supplied when registering must be of the same domain as the webpage attempting to perform the registration or the registration will fail. For example, http://example.com/homepage.html can register a protocol handler for http://example.com/handle_mailto/%s, but not for http://example.org/handle_mailto/%s.

+

Note: The URL template supplied when registering must be of the same domain as the webpage attempting to perform the registration or the registration will fail. For example, http://example.com/homepage.html can register a protocol handler for http://example.com/handle_mailto/%s, but not for http://example.org/handle_mailto/%s.

Registering the same protocol handler more than once will pop up a different notification, indicating that the protocol handler is already registered. Therefore, it is a good idea to guard your call to register the protocol handler with a check to see if it is already registered, such as in the example below.

@@ -86,7 +86,7 @@

Handling

Server side code can extract the query string parameters and perform the desired action.

-

Note:The server side code is passed the entire contents of the href. This means the server side code will have to parse out the protocol from the data.

+

Note: The server side code is passed the entire contents of the href. This means the server side code will have to parse out the protocol from the data.

Example

diff --git a/files/en-us/web/api/notification/close/index.html b/files/en-us/web/api/notification/close/index.html index 8d3799b565b0e2a..6065b19405fe7d5 100644 --- a/files/en-us/web/api/notification/close/index.html +++ b/files/en-us/web/api/notification/close/index.html @@ -17,7 +17,7 @@ close/remove a previously displayed notification.

-

Note: This API shouldn't be used just to have the notification +

Note: This API shouldn't be used just to have the notification removed from the screen after a fixed delay since this method will also remove the notification from any notification tray, preventing users from interacting with it after it was initially shown. A valid use for this API would be to remove a diff --git a/files/en-us/web/api/permissions_api/index.html b/files/en-us/web/api/permissions_api/index.html index 587107866f70412..821d3029d44855c 100644 --- a/files/en-us/web/api/permissions_api/index.html +++ b/files/en-us/web/api/permissions_api/index.html @@ -15,7 +15,7 @@

The Permissions API provides a consistent programmatic way to query the status of API permissions attributed to the current context. For example, the Permissions API can be used to determine if permission to access a particular API has been granted or denied.

-

Note: This feature is available in Web Workers (although not current versions of Firefox, as WorkerNavigator.permissions is not implemented).

+

Note: This feature is available in Web Workers (although not current versions of Firefox, as WorkerNavigator.permissions is not implemented).

Concepts and usage

diff --git a/files/en-us/web/api/pointer_events/index.html b/files/en-us/web/api/pointer_events/index.html index 410beafdcdda400..50a360a0be30572 100644 --- a/files/en-us/web/api/pointer_events/index.html +++ b/files/en-us/web/api/pointer_events/index.html @@ -15,7 +15,7 @@

Much of today's web content assumes the user's pointing device will be a mouse. However, since many devices support other types of pointing input devices, such as pen/stylus and touch surfaces, extensions to the existing pointing device event models are needed. Pointer events address that need.

-

Note: Pointer events are not available in Web Workers.

+

Note: Pointer events are not available in Web Workers.

Pointer events are DOM events that are fired for a pointing device. They are designed to create a single DOM event model to handle pointing input devices such as a mouse, pen/stylus or touch (such as one or more fingers).

diff --git a/files/en-us/web/api/publickeycredentialrequestoptions/allowcredentials/index.html b/files/en-us/web/api/publickeycredentialrequestoptions/allowcredentials/index.html index 159718ff6f45353..60b64f4b09aeb4f 100644 --- a/files/en-us/web/api/publickeycredentialrequestoptions/allowcredentials/index.html +++ b/files/en-us/web/api/publickeycredentialrequestoptions/allowcredentials/index.html @@ -18,8 +18,7 @@ credential descriptors.

-

Note: - {{domxref("PublicKeyCredentialCreationOptions.excludeCredentials")}} may be used +

Note: {{domxref("PublicKeyCredentialCreationOptions.excludeCredentials")}} may be used during the creation of the credentials in order to avoid creating new credentials for an existing user with existing public key credential. Contrary to allowCredentials, it is used to filter out credentials.

diff --git a/files/en-us/web/api/remote_playback_api/index.html b/files/en-us/web/api/remote_playback_api/index.html index 030b6ad6c2233d6..77cacdcd3be402b 100644 --- a/files/en-us/web/api/remote_playback_api/index.html +++ b/files/en-us/web/api/remote_playback_api/index.html @@ -18,7 +18,7 @@

Concepts and Usage

The API enables a page, which has an media element such as a video or audio file, to initiate and control playback of that media on a connected remote device. For example, playing a video on a connected TV.

-

Note:Safari for iOS has some APIs which enable remote playback on AirPlay. Details of these can be found in the Safari 9.0 release notes.

+

Note: Safari for iOS has some APIs which enable remote playback on AirPlay. Details of these can be found in the Safari 9.0 release notes.

Android versions of Firefox and Chrome also contain some remote playback features. These devices will show a Cast button if there is a Cast device available in the local network.

diff --git a/files/en-us/web/api/touchevent/index.html b/files/en-us/web/api/touchevent/index.html index 494ebd3cdd3ec36..215d4855d9c897b 100644 --- a/files/en-us/web/api/touchevent/index.html +++ b/files/en-us/web/api/touchevent/index.html @@ -97,10 +97,7 @@

Touch event types

if the values of the radius, rotation angle, or force attributes of a touch point change.

-

Note: - The rate at which touchmove events is sent is browser-specific, - and may also vary depending on the capability of the user's hardware. - You must not rely on a specific granularity of these events. +

Note: The rate at which touchmove events is sent is browser-specific, and may also vary depending on the capability of the user's hardware. You must not rely on a specific granularity of these events.

diff --git a/files/en-us/web/api/web_animations_api/using_the_web_animations_api/index.html b/files/en-us/web/api/web_animations_api/using_the_web_animations_api/index.html index cb635ab01b62f60..249974da5e99732 100644 --- a/files/en-us/web/api/web_animations_api/using_the_web_animations_api/index.html +++ b/files/en-us/web/api/web_animations_api/using_the_web_animations_api/index.html @@ -319,7 +319,7 @@

Getting information out of animat
-

Note: getAnimations() and effect are not shipping in all browsers as of this writing, but the polyfill does support them today.

+

Note: getAnimations() and effect are not shipping in all browsers as of this writing, but the polyfill does support them today.

Callbacks and promises

diff --git a/files/en-us/web/api/web_audio_api/advanced_techniques/index.html b/files/en-us/web/api/web_audio_api/advanced_techniques/index.html index 5867c550dbad01b..1557fdff29440b5 100644 --- a/files/en-us/web/api/web_audio_api/advanced_techniques/index.html +++ b/files/en-us/web/api/web_audio_api/advanced_techniques/index.html @@ -198,7 +198,7 @@

Connecting the graph

osc.stop(time + pulseTime);
-

Note: We also don't have to use the default wave types for either of these oscillators we're creating — we could use a wavetable and the periodic wave method as we did before. There is a multitude of possibilities with just a minimum of nodes.

+

Note: We also don't have to use the default wave types for either of these oscillators we're creating — we could use a wavetable and the periodic wave method as we did before. There is a multitude of possibilities with just a minimum of nodes.

Pulse user controls

diff --git a/files/en-us/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.html b/files/en-us/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.html index 782a5fe41e3bf3d..26ea0564748cf5b 100644 --- a/files/en-us/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.html +++ b/files/en-us/web/api/web_audio_api/basic_concepts_behind_web_audio_api/index.html @@ -84,7 +84,7 @@

Audio buffers: frames, sample var buffer = context.createBuffer(2, 22050, 44100);
-

Note: In digital audio44,100 Hz (alternately represented as 44.1 kHz) is a common sampling frequency. Why 44.1kHz? 
+

Note: In digital audio44,100 Hz (alternately represented as 44.1 kHz) is a common sampling frequency. Why 44.1kHz? 

Firstly, because the hearing range of human ears is roughly 20 Hz to 20,000 Hz. Via the Nyquist–Shannon sampling theorem, the sampling frequency must be greater than twice the maximum frequency one wishes to reproduce. Therefore, the sampling rate has to be greater than 40 kHz.

@@ -99,7 +99,7 @@

Audio buffers: frames, sample

If you use this call, you will get a mono buffer with just one channel), that when played back on an AudioContext running at 44100Hz, will be automatically resampled to 44100Hz (and therefore yield 44100 frames), and last for 1.0 second: 44100 frames/44100Hz = 1 second.

-

Note: audio resampling is very similar to image resizing. Say you've got a 16 x 16 image, but you want it to fill a 32x32 area. You resize (or resample) it. The result has less quality (it can be blurry or edgy, depending on the resizing algorithm), but it works, with the resized image taking up less space. Resampled audio is exactly the same: you save space, but in practice you will be unable to properly reproduce high frequency content, or treble sound.

+

Note: Audio resampling is very similar to image resizing. Say you've got a 16 x 16 image, but you want it to fill a 32x32 area. You resize (or resample) it. The result has less quality (it can be blurry or edgy, depending on the resizing algorithm), but it works, with the resized image taking up less space. Resampled audio is exactly the same: you save space, but in practice you will be unable to properly reproduce high frequency content, or treble sound.

Planar versus interleaved buffers

diff --git a/files/en-us/web/api/web_audio_api/using_audioworklet/index.html b/files/en-us/web/api/web_audio_api/using_audioworklet/index.html index cda0a9322c5be14..6f27d430e55798b 100644 --- a/files/en-us/web/api/web_audio_api/using_audioworklet/index.html +++ b/files/en-us/web/api/web_audio_api/using_audioworklet/index.html @@ -188,7 +188,7 @@

Lifetime of an audio worklet pro

Returning false from the process() method tells the API that it should follow its normal logic and shut down your processor node if it deems it appropriate to do so. If the API determines that your node is no longer needed, process() will not be called again.

-

Note: At this time, unfortunately, Chrome does not implement this algorithm in a manner that matches the current standard. Instead, it keeps the node alive if you return true and shuts it down if you return false. Thus for compatibility reasons you must always return true from process(), at least on Chrome. However, once this Chrome issue is fixed, you will want to change this behavior if possible as it may have a slight negative impact on performance.

+

Note: At this time, unfortunately, Chrome does not implement this algorithm in a manner that matches the current standard. Instead, it keeps the node alive if you return true and shuts it down if you return false. Thus for compatibility reasons you must always return true from process(), at least on Chrome. However, once this Chrome issue is fixed, you will want to change this behavior if possible as it may have a slight negative impact on performance.

Creating an audio processor worklet node

diff --git a/files/en-us/web/api/web_workers_api/index.html b/files/en-us/web/api/web_workers_api/index.html index d2dbf27f118f08d..e4b46bf1f1f373a 100644 --- a/files/en-us/web/api/web_workers_api/index.html +++ b/files/en-us/web/api/web_workers_api/index.html @@ -12,7 +12,7 @@

Web Workers makes it possible to run a script operation in a background thread separate from the main execution thread of a web application. The advantage of this is that laborious processing can be performed in a separate thread, allowing the main (usually the UI) thread to run without being blocked/slowed down.

-

Note: Web Workers can also use the Web Worker API (i.e. workers can spawn workers, provided they are hosted within the same origin as the parent page).

+

Note: Web Workers can also use the Web Worker API (i.e. workers can spawn workers, provided they are hosted within the same origin as the parent page).

Web Workers concepts and usage

diff --git a/files/en-us/web/api/webrtc_api/signaling_and_video_calling/index.html b/files/en-us/web/api/webrtc_api/signaling_and_video_calling/index.html index 9b7d63b3c7387fc..86b6f4815b7843a 100644 --- a/files/en-us/web/api/webrtc_api/signaling_and_video_calling/index.html +++ b/files/en-us/web/api/webrtc_api/signaling_and_video_calling/index.html @@ -648,7 +648,7 @@
ICE connection state

Here, we apply our closeVideoCall() function when the ICE connection state changes to "closed" or "failed". This handles shutting down our end of the connection so that we're ready start or accept a call once again.

-

Note: We don't watch the disconnected signaling state here as it can indicate temporary issues and may go back to a connected state after some time. Watching it would close the video call on any temporary network issue.

+

Note: We don't watch the disconnected signaling state here as it can indicate temporary issues and may go back to a connected state after some time. Watching it would close the video call on any temporary network issue.

ICE signaling state
diff --git a/files/en-us/web/api/webvr_api/concepts/index.html b/files/en-us/web/api/webvr_api/concepts/index.html index b7c2ad160f314d3..5f2725c9638155b 100644 --- a/files/en-us/web/api/webvr_api/concepts/index.html +++ b/files/en-us/web/api/webvr_api/concepts/index.html @@ -16,7 +16,7 @@ ---
{{APIRef("WebVR API")}}{{deprecated_header}}
-

Note: WebVR API is replaced by WebXR API. WebVR was never ratified as a standard, was implemented and enabled by default in very few browsers and supported a small number of devices.

+

Note: WebVR API is replaced by WebXR API. WebVR was never ratified as a standard, was implemented and enabled by default in very few browsers and supported a small number of devices.

This article discusses some of the concepts and theory behind virtual reality (VR). If you are a newcomer to the area, it is worthwhile getting an understanding of these topics before you start diving into code.

diff --git a/files/en-us/web/api/webvr_api/index.html b/files/en-us/web/api/webvr_api/index.html index 3630be88b967c5d..934dc3eb068e77b 100644 --- a/files/en-us/web/api/webvr_api/index.html +++ b/files/en-us/web/api/webvr_api/index.html @@ -14,7 +14,7 @@ ---

{{DefaultAPISidebar("WebVR API")}}{{Deprecated_Header}}

-

Note: WebVR API is replaced by WebXR API. WebVR was never ratified as a standard, was implemented and enabled by default in very few browsers and supported a small number of devices.

+

Note: WebVR API is replaced by WebXR API. WebVR was never ratified as a standard, was implemented and enabled by default in very few browsers and supported a small number of devices.

WebVR provides support for exposing virtual reality devices — for example, head-mounted displays like the Oculus Rift or HTC Vive — to web apps, enabling developers to translate position and movement information from the display into movement around a 3D scene. This has numerous, interesting applications, from virtual product tours and interactive training apps to immersive first-person games.

diff --git a/files/en-us/web/api/wheelevent/index.html b/files/en-us/web/api/wheelevent/index.html index 33d3b91764588d7..f2ecfb412d2e5ff 100644 --- a/files/en-us/web/api/wheelevent/index.html +++ b/files/en-us/web/api/wheelevent/index.html @@ -14,7 +14,7 @@

The WheelEvent interface represents events that occur due to the user moving a mouse wheel or similar input device.

-

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.

+

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.

diff --git a/files/en-us/web/api/window/defaultstatus/index.html b/files/en-us/web/api/window/defaultstatus/index.html index 41a26aada4ca62d..86d9204a0e62b51 100644 --- a/files/en-us/web/api/window/defaultstatus/index.html +++ b/files/en-us/web/api/window/defaultstatus/index.html @@ -16,7 +16,7 @@

{{APIRef()}}{{deprecated_header}}

-

Note:This method was removed from Firefox 23 and onward.

+

Note: This method was removed from Firefox 23 and onward.

Summary

From 65df2630b8f725c9dc5c34d38732276759db2c99 Mon Sep 17 00:00:00 2001 From: Will Bamberg Date: Wed, 1 Sep 2021 16:31:04 -0700 Subject: [PATCH 2/2] Ensure Warning: is followed by a space --- .../web/api/canvasrenderingcontext2d/putimagedata/index.html | 2 +- files/en-us/web/api/console/profileend/index.html | 2 +- files/en-us/web/api/document/keypress_event/index.html | 2 +- files/en-us/web/api/element/scrollleft/index.html | 2 +- files/en-us/web/api/eventsource/index.html | 2 +- files/en-us/web/api/filereadersync/index.html | 2 +- files/en-us/web/api/globaleventhandlers/onkeypress/index.html | 2 +- .../html_drag_and_drop_api/recommended_drag_types/index.html | 4 ++-- files/en-us/web/api/htmlimageelement/hspace/index.html | 2 +- files/en-us/web/api/htmlimageelement/name/index.html | 2 +- files/en-us/web/api/htmlimageelement/vspace/index.html | 2 +- files/en-us/web/api/idbenvironmentsync/index.html | 2 +- files/en-us/web/api/keyboardevent/charcode/index.html | 2 +- .../api/localfilesystemsync/requestfilesystemsync/index.html | 4 +--- files/en-us/web/api/mouseevent/initmouseevent/index.html | 2 +- .../en-us/web/api/pushsubscription/subscriptionid/index.html | 2 +- files/en-us/web/api/screen/lockorientation/index.html | 2 +- .../server-sent_events/using_server-sent_events/index.html | 2 +- .../api/sharedworkerglobalscope/applicationcache/index.html | 2 +- files/en-us/web/api/textrange/index.html | 2 +- files/en-us/web/api/web_authentication_api/index.html | 2 +- files/en-us/web/api/window/applicationcache/index.html | 2 +- 22 files changed, 23 insertions(+), 25 deletions(-) diff --git a/files/en-us/web/api/canvasrenderingcontext2d/putimagedata/index.html b/files/en-us/web/api/canvasrenderingcontext2d/putimagedata/index.html index b900e6b003cfefc..dc2c16c25a17a7e 100644 --- a/files/en-us/web/api/canvasrenderingcontext2d/putimagedata/index.html +++ b/files/en-us/web/api/canvasrenderingcontext2d/putimagedata/index.html @@ -121,7 +121,7 @@

Result

Data loss due to browser optimization

-

Warning: Due to the lossy nature of converting to and from premultiplied alpha color values, +

Warning: Due to the lossy nature of converting to and from premultiplied alpha color values, pixels that have just been set using putImageData() might be returned to an equivalent getImageData() as different values.

diff --git a/files/en-us/web/api/console/profileend/index.html b/files/en-us/web/api/console/profileend/index.html index 37fd5b79fa9cb79..f0d24eb345f19e2 100644 --- a/files/en-us/web/api/console/profileend/index.html +++ b/files/en-us/web/api/console/profileend/index.html @@ -16,7 +16,7 @@

{{APIRef("Console API")}}{{Non-standard_header}}

-

Warning: Calling this API immediately after console.profile() can cause it to not work. To +

Warning: Calling this API immediately after console.profile() can cause it to not work. To work around this, call it in a setTimeout with at least 5ms delay. See {{bug(1240249)}}.

diff --git a/files/en-us/web/api/document/keypress_event/index.html b/files/en-us/web/api/document/keypress_event/index.html index 6d30bbf803bf8c3..37b5eba57cda52a 100644 --- a/files/en-us/web/api/document/keypress_event/index.html +++ b/files/en-us/web/api/document/keypress_event/index.html @@ -16,7 +16,7 @@

Examples of keys that produce a character value are alphabetic, numeric, and punctuation keys. Examples of keys that don't produce a character value are modifier keys such as Alt, Shift, Ctrl, or Meta.

-

Warning: Since this event has been deprecated, you should look to use beforeinput or keydown instead.

+

Warning: Since this event has been deprecated, you should look to use beforeinput or keydown instead.

diff --git a/files/en-us/web/api/element/scrollleft/index.html b/files/en-us/web/api/element/scrollleft/index.html index d9c5267416383c3..6e2a88624c50a74 100644 --- a/files/en-us/web/api/element/scrollleft/index.html +++ b/files/en-us/web/api/element/scrollleft/index.html @@ -19,7 +19,7 @@ scroll towards the end of the content.

-

Warning: On systems using display scaling, scrollLeft may give you a decimal +

Warning: On systems using display scaling, scrollLeft may give you a decimal value.

diff --git a/files/en-us/web/api/eventsource/index.html b/files/en-us/web/api/eventsource/index.html index 8d29e4da63b3398..6a08502d833a96e 100644 --- a/files/en-us/web/api/eventsource/index.html +++ b/files/en-us/web/api/eventsource/index.html @@ -23,7 +23,7 @@

Unlike WebSockets, server-sent events are unidirectional; that is, data messages are delivered in one direction, from the server to the client (such as a user's web browser). That makes them an excellent choice when there's no need to send data from the client to the server in message form. For example, EventSource is a useful approach for handling things like social media status updates, news feeds, or delivering data into a client-side storage mechanism like IndexedDB or web storage.

-

Warning: When not used over HTTP/2, SSE suffers from a limitation to the maximum number of open connections, which can be specially painful when opening various tabs as the limit is per browser and set to a very low number (6). The issue has been marked as "Won't fix" in Chrome and Firefox. This limit is per browser + domain, so that means that you can open 6 SSE connections across all of the tabs to www.example1.com and another 6 SSE connections to www.example2.com. (from Stackoverflow). When using HTTP/2, the maximum number of simultaneous HTTP streams is negotiated between the server and the client (defaults to 100).

+

Warning: When not used over HTTP/2, SSE suffers from a limitation to the maximum number of open connections, which can be specially painful when opening various tabs as the limit is per browser and set to a very low number (6). The issue has been marked as "Won't fix" in Chrome and Firefox. This limit is per browser + domain, so that means that you can open 6 SSE connections across all of the tabs to www.example1.com and another 6 SSE connections to www.example2.com. (from Stackoverflow). When using HTTP/2, the maximum number of simultaneous HTTP streams is negotiated between the server and the client (defaults to 100).

Constructor

diff --git a/files/en-us/web/api/filereadersync/index.html b/files/en-us/web/api/filereadersync/index.html index f886828b32f0405..e0c22ba2cf89efb 100644 --- a/files/en-us/web/api/filereadersync/index.html +++ b/files/en-us/web/api/filereadersync/index.html @@ -13,7 +13,7 @@

{{AvailableInWorkers}}

-

Warning: This interface is only available in workers as it enables synchronous I/O that could potentially block.

+

Warning: This interface is only available in workers as it enables synchronous I/O that could potentially block.

Properties

diff --git a/files/en-us/web/api/globaleventhandlers/onkeypress/index.html b/files/en-us/web/api/globaleventhandlers/onkeypress/index.html index c722adfcffd0c37..c81d22c38a18335 100644 --- a/files/en-us/web/api/globaleventhandlers/onkeypress/index.html +++ b/files/en-us/web/api/globaleventhandlers/onkeypress/index.html @@ -22,7 +22,7 @@ certain keys.

-

Warning: The onkeypress event handler has been deprecated. You may want to use +

Warning: The onkeypress event handler has been deprecated. You may want to use {{domxref("GlobalEventHandlers.onkeydown", "onkeydown")}} instead.

diff --git a/files/en-us/web/api/html_drag_and_drop_api/recommended_drag_types/index.html b/files/en-us/web/api/html_drag_and_drop_api/recommended_drag_types/index.html index c8cd3113e16ab46..f14885e0175e584 100644 --- a/files/en-us/web/api/html_drag_and_drop_api/recommended_drag_types/index.html +++ b/files/en-us/web/api/html_drag_and_drop_api/recommended_drag_types/index.html @@ -42,7 +42,7 @@

To drag multiple links, separate each link inside the text/uri-list data with a CRLF linebreak. Lines that begin with a number sign (#) are comments, and should not be considered URLs. You can use comments to indicate the purpose of a URL, the title associated with a URL, or other data.

-

Warning: The text/plain fallback for multiple links should include all URLs, but no comments.

+

Warning: The text/plain fallback for multiple links should include all URLs, but no comments.

For example, this sample text/uri-list data contains two links and a comment:

@@ -55,7 +55,7 @@

When retrieving a dropped link, ensure you handle when multiple links are dragged, including any comments. For convenience, the special type URL may be used to refer to the first valid link within data for the text/uri-list type.

-

Warning: Do not add data with the URL type — attempting to do so will set the value of the text/uri-list type instead.

+

Warning: Do not add data with the URL type — attempting to do so will set the value of the text/uri-list type instead.

var url = event.dataTransfer.getData("URL");
diff --git a/files/en-us/web/api/htmlimageelement/hspace/index.html b/files/en-us/web/api/htmlimageelement/hspace/index.html
index 4a3752fe25c06e8..b04437025509944 100644
--- a/files/en-us/web/api/htmlimageelement/hspace/index.html
+++ b/files/en-us/web/api/htmlimageelement/hspace/index.html
@@ -49,7 +49,7 @@ 

Usage notes

pixels.

-

Warning: This property is obsolete. You should instead use the CSS +

Warning: This property is obsolete. You should instead use the CSS {{cssxref("margin")}} property and its longhand forms to establish margins around an <img>.

diff --git a/files/en-us/web/api/htmlimageelement/name/index.html b/files/en-us/web/api/htmlimageelement/name/index.html index 1a9d723f4778fe0..c7e71f1dc294559 100644 --- a/files/en-us/web/api/htmlimageelement/name/index.html +++ b/files/en-us/web/api/htmlimageelement/name/index.html @@ -32,7 +32,7 @@

Value

A {{domxref("DOMString")}} providing a name by which the image can be referenced.

-

Warning: This property is deprecated and is only in the +

Warning: This property is deprecated and is only in the specification still for backward compatibility purposes. Since it functions identically to {{htmlattrxref("id")}}, you can and should use it instead.

diff --git a/files/en-us/web/api/htmlimageelement/vspace/index.html b/files/en-us/web/api/htmlimageelement/vspace/index.html index c2d96172fb6c410..7efdeee9c79ccfa 100644 --- a/files/en-us/web/api/htmlimageelement/vspace/index.html +++ b/files/en-us/web/api/htmlimageelement/vspace/index.html @@ -45,7 +45,7 @@

Usage notes

pixels.

-

Warning: This property is obsolete. You should instead use the CSS +

Warning: This property is obsolete. You should instead use the CSS {{cssxref("margin")}} property and its longhand forms to establish margins around an <img>.

diff --git a/files/en-us/web/api/idbenvironmentsync/index.html b/files/en-us/web/api/idbenvironmentsync/index.html index 0c126f0d1cc4b7a..869a39448be659d 100644 --- a/files/en-us/web/api/idbenvironmentsync/index.html +++ b/files/en-us/web/api/idbenvironmentsync/index.html @@ -12,7 +12,7 @@

{{APIRef("IndexedDB")}} {{ draft() }}

-

Warning: The synchronous version of the IndexedDB API was originally intended for use only with Web Workers, and was eventually removed from the spec because its need was questionable. It may however be reintroduced in the future if there is enough demand from web developers.

+

Warning: The synchronous version of the IndexedDB API was originally intended for use only with Web Workers, and was eventually removed from the spec because its need was questionable. It may however be reintroduced in the future if there is enough demand from web developers.

The {{ unimplemented_inline() }} IDBEnvironmentSync interface of the IndexedDB API will be implemented by worker objects.

diff --git a/files/en-us/web/api/keyboardevent/charcode/index.html b/files/en-us/web/api/keyboardevent/charcode/index.html index b2020cc9d7ac10c..a9e04023d45f547 100644 --- a/files/en-us/web/api/keyboardevent/charcode/index.html +++ b/files/en-us/web/api/keyboardevent/charcode/index.html @@ -17,7 +17,7 @@ pressed during a {{Event("keypress")}} event.

-

Warning: 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/localfilesystemsync/requestfilesystemsync/index.html b/files/en-us/web/api/localfilesystemsync/requestfilesystemsync/index.html index de9f814e81e65b8..6da2b73439f131a 100644 --- a/files/en-us/web/api/localfilesystemsync/requestfilesystemsync/index.html +++ b/files/en-us/web/api/localfilesystemsync/requestfilesystemsync/index.html @@ -8,9 +8,7 @@

The requestFileSystemSync method of the LocalFileSystemSync interface of the File System API creates a new a sandboxed file system. It is intended to be used with WebWorkers. The methods are implemented by worker objects.

-

Warning:

- -

This document was last updated on March 2, 2012 and follows the W3C Specifications (Working Draft) drafted on April 19, 2011.

+

Warning: This document was last updated on March 2, 2012 and follows the W3C Specifications (Working Draft) drafted on April 19, 2011.

This specification is more or less abandoned, failing to get significant traction.

diff --git a/files/en-us/web/api/mouseevent/initmouseevent/index.html b/files/en-us/web/api/mouseevent/initmouseevent/index.html index 49956bc53f42bb0..68d859ad8f69f60 100644 --- a/files/en-us/web/api/mouseevent/initmouseevent/index.html +++ b/files/en-us/web/api/mouseevent/initmouseevent/index.html @@ -18,7 +18,7 @@
-

Warning: 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("MouseEvent.MouseEvent", "MouseEvent()")}}. The page on Creating and triggering events gives more information about the way to use these.

diff --git a/files/en-us/web/api/pushsubscription/subscriptionid/index.html b/files/en-us/web/api/pushsubscription/subscriptionid/index.html index 4c2d5cb0bc99cce..ef988d76c674d29 100644 --- a/files/en-us/web/api/pushsubscription/subscriptionid/index.html +++ b/files/en-us/web/api/pushsubscription/subscriptionid/index.html @@ -21,7 +21,7 @@ the subscription ID associated with the push subscription.

-

Warning: Instead of this feature, use the {{domxref("PushSubscription.endPoint")}} property on the same interface.

+

Warning: Instead of this feature, use the {{domxref("PushSubscription.endPoint")}} property on the same interface.

Syntax

diff --git a/files/en-us/web/api/screen/lockorientation/index.html b/files/en-us/web/api/screen/lockorientation/index.html index acf4fcc73932892..dfb64d30b785beb 100644 --- a/files/en-us/web/api/screen/lockorientation/index.html +++ b/files/en-us/web/api/screen/lockorientation/index.html @@ -17,7 +17,7 @@ interface locks the screen into a specified orientation.

-

Warning: This feature is deprecated and should be avoided. Use the {{DOMxRef("ScreenOrientation.lock()")}} method instead.

+

Warning: This feature is deprecated and should be avoided. Use the {{DOMxRef("ScreenOrientation.lock()")}} method instead.

diff --git a/files/en-us/web/api/server-sent_events/using_server-sent_events/index.html b/files/en-us/web/api/server-sent_events/using_server-sent_events/index.html index c46e0d292ab76e7..ed1ada0550a63c4 100644 --- a/files/en-us/web/api/server-sent_events/using_server-sent_events/index.html +++ b/files/en-us/web/api/server-sent_events/using_server-sent_events/index.html @@ -52,7 +52,7 @@

Receiving events from the server

This code is similar, except that it will be called automatically whenever the server sends a message with the event field set to "ping"; it then parses the JSON in the data field and outputs that information.

-

Warning: When not used over HTTP/2, SSE suffers from a limitation to the maximum number of open connections, which can be especially painful when opening multiple tabs, as the limit is per browser and is set to a very low number (6). The issue has been marked as "Won't fix" in Chrome and Firefox. This limit is per browser + domain, which means that you can open 6 SSE connections across all of the tabs to www.example1.com and another 6 SSE connections to www.example2.com (per Stackoverflow). When using HTTP/2, the maximum number of simultaneous HTTP streams is negotiated between the server and the client (defaults to 100).

+

Warning: When not used over HTTP/2, SSE suffers from a limitation to the maximum number of open connections, which can be especially painful when opening multiple tabs, as the limit is per browser and is set to a very low number (6). The issue has been marked as "Won't fix" in Chrome and Firefox. This limit is per browser + domain, which means that you can open 6 SSE connections across all of the tabs to www.example1.com and another 6 SSE connections to www.example2.com (per Stackoverflow). When using HTTP/2, the maximum number of simultaneous HTTP streams is negotiated between the server and the client (defaults to 100).

Sending events from the server

diff --git a/files/en-us/web/api/sharedworkerglobalscope/applicationcache/index.html b/files/en-us/web/api/sharedworkerglobalscope/applicationcache/index.html index a3ee3d8ea6c16b2..cc69038124cc3ef 100644 --- a/files/en-us/web/api/sharedworkerglobalscope/applicationcache/index.html +++ b/files/en-us/web/api/sharedworkerglobalscope/applicationcache/index.html @@ -14,7 +14,7 @@
{{Deprecated_Header}}{{APIRef("Web Workers API")}}
-

Warning: Application Cache is deprecated as of Firefox 44, and is no longer available in insecure contexts from Firefox 60 onwards ({{bug(1354175)}}, currently Nightly/Beta only). Don't use it to make offline websites — consider using service workers instead.

+

Warning: Application Cache is deprecated as of Firefox 44, and is no longer available in insecure contexts from Firefox 60 onwards ({{bug(1354175)}}, currently Nightly/Beta only). Don't use it to make offline websites — consider using service workers instead.

The applicationCache read-only property of the {{domxref("SharedWorkerGlobalScope")}} interface returns the {{domxref("ApplicationCache")}} object for the worker (see Using the application cache).

diff --git a/files/en-us/web/api/textrange/index.html b/files/en-us/web/api/textrange/index.html index b864ca29ccbc224..0cd5e09f906059b 100644 --- a/files/en-us/web/api/textrange/index.html +++ b/files/en-us/web/api/textrange/index.html @@ -10,7 +10,7 @@
{{ ApiRef("DOM") }}{{Non-standard_Header}}
-

Warning: This property is IE specific. Although it is well supported by IE, most other browsers no longer support this property. This property should only be used as one of the solutions when you need to be compatible with lower versions of IE, rather than relying on it completely in cross browser scripts.

+

Warning: This property is IE specific. Although it is well supported by IE, most other browsers no longer support this property. This property should only be used as one of the solutions when you need to be compatible with lower versions of IE, rather than relying on it completely in cross browser scripts.

TextRange object represents a fragment of text in a document, similar to the standard defined {{domxref("Range")}} interface.

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 a8d66e3750f668b..9b2fed55fdb4d39 100644 --- a/files/en-us/web/api/web_authentication_api/index.html +++ b/files/en-us/web/api/web_authentication_api/index.html @@ -127,7 +127,7 @@

Options

Examples

-

Warning: For security reasons, web authentication calls ({{domxref('CredentialsContainer.create','create()')}} and {{domxref('CredentialsContainer.get','get()')}}) are cancelled if the browser window loses focus while the call is pending.

+

Warning: For security reasons, web authentication calls ({{domxref('CredentialsContainer.create','create()')}} and {{domxref('CredentialsContainer.get','get()')}}) are cancelled if the browser window loses focus while the call is pending.

// sample arguments for registration
diff --git a/files/en-us/web/api/window/applicationcache/index.html b/files/en-us/web/api/window/applicationcache/index.html
index cea48431050bc8c..9bd6537fd0b1e76 100644
--- a/files/en-us/web/api/window/applicationcache/index.html
+++ b/files/en-us/web/api/window/applicationcache/index.html
@@ -16,7 +16,7 @@
 

{{Deprecated_Header}}{{Non-standard_Header}}

-

Warning: Application Cache is deprecated as of Firefox 44, and is no longer available in +

Warning: Application Cache is deprecated as of Firefox 44, and is no longer available in insecure contexts from Firefox 60 onwards ({{bug(1354175)}}, currently Nightly/Beta only). Don't use it to offline websites — consider using service workers instead.