Skip to content

Commit

Permalink
Merge branch 'main' into fix-issue-37597
Browse files Browse the repository at this point in the history
  • Loading branch information
SurajKharkwal authored Jan 13, 2025
2 parents 975bfad + 4c2bb5b commit d8885a4
Show file tree
Hide file tree
Showing 20 changed files with 39 additions and 29 deletions.
5 changes: 5 additions & 0 deletions .vscode/dictionaries/ignore-list.txt
Original file line number Diff line number Diff line change
Expand Up @@ -112,9 +112,11 @@ dubby
Duden
dXNlcm5hbWU6cGFzc3dvcmQ
EACC
efregre
eirmod
elitr
ERHGDFy
ertgrth
esset
essum
Ethere
Expand Down Expand Up @@ -173,6 +175,7 @@ isnt
isoff
javascripts
jdoe
Jgfbgfdgt
jngl
jnglstore
js13kgames
Expand Down Expand Up @@ -253,6 +256,7 @@ rebum
regelialia
rheeeeet
ricebean
rtgtfghhyj
s3pPLMBiTxaQ9kYGzzhZRbK
sadipscing
sagnarelli
Expand Down Expand Up @@ -306,6 +310,7 @@ webglsamples
webvr
weta
Whereami
Whereshire
wisen
wisi
Wookie
Expand Down
2 changes: 2 additions & 0 deletions .vscode/dictionaries/proper-names.txt
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ Béziers
caitmuenster
Camino
Camtasia
Canva
Carakan
Cardano
carinaanand
Expand Down Expand Up @@ -567,6 +568,7 @@ Theora
Thierry
Tidwell
Tink
tinypng
Titilayo
Tokopedia
Tomayac
Expand Down
1 change: 1 addition & 0 deletions .vscode/dictionaries/terms-abbreviations.txt
Original file line number Diff line number Diff line change
Expand Up @@ -714,6 +714,7 @@ sundried
sunsetting
supercookie
superdomain
superpowered
superscaling
supersets
SVCB
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -89,15 +89,15 @@ All web pages can each be found at a unique location (web address, also called a

A _website_ is a collection of linked web pages (plus their associated resources) that share a unique [domain name](/en-US/docs/Learn_web_development/Howto/Web_mechanics/What_is_a_domain_name). Each web page of a given website provides explicit links—most of the time in the form of clickable portions of text—that allow the user to move from one page of the website to another.

When you load your favourite website in a browser, it tends to first display the website's main web page, or _homepage_ (casually referred to as "home"):
When you load your favorite website in a browser, it tends to first display the website's main web page, or _homepage_ (casually referred to as "home"):

![Example of a website domain name in the browser address bar](web-site.jpg)

> [!CALLOUT]
>
> **Try it out**
>
> Try clicking some menu items or links to look at some different pages on your favourite website.
> Try clicking some menu items or links to look at some different pages on your favorite website.
> [!NOTE]
> It is also possible to have a [_single-page app_](/en-US/docs/Glossary/SPA): a website that consists of a single web page that is dynamically updated with new content when needed.
Expand Down Expand Up @@ -146,11 +146,11 @@ When you access the web, quite a lot happens between your first interaction (for

This description of how the web works is heavily simplified, but it is all you really need to know at this point. You will find a more detailed account of how web pages and requested and rendered by a web browser in our [Web standards](/en-US/docs/Learn_web_development/Getting_started/Web_standards) module, slightly later on.

For now, try opening a web browser and loading up a couple of your favourite sites, thinking about the above steps as you do so.
For now, try opening a web browser and loading up a couple of your favorite sites, thinking about the above steps as you do so.

## Searching for information

As a web developer, you will spend a lot of time searching for information, from syntax you can't remember to solutions to specific problems. It is therefore a good idea to learn how to effecively search the web.
As a web developer, you will spend a lot of time searching for information, from syntax you can't remember to solutions to specific problems. It is therefore a good idea to learn how to effectively search the web.

If you are looking for general information about a specific web technology feature, you should type the name of the feature into the MDN search box. For example, try typing `box model`, `fetch()` or `video element` into the the search box and see what comes up. If you don't find the information you need, try expanding your search — try your search term in a search engine.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Previously, we told you to install a code editor, as you'll need one to work thr

Before starting to code, you may have had some experience working on text documents in a program like Microsoft Word. You might also be wondering whether you can work with code in these same programs. Unfortunately, the answer is "not really":

- Programs like Micosoft Word are **Binary file** editors; their files contain a non-text format that can only be understood by those programs. Website source code, on the other hand, is stored as plain text.
- Programs like Microsoft Word are **Binary file** editors; their files contain a non-text format that can only be understood by those programs. Website source code, on the other hand, is stored as plain text.
- Word _can_ open and edit plain text files, but it doesn't handle them very well. It doesn't have a featureset designed for working with code — it is for writing documents such as letters and reports. You need a program that is designed to cleanly handle and output plain text, and work with code.

You probably already have a plain text editor on your computer. By default, Windows includes [Notepad](https://en.wikipedia.org/wiki/Microsoft_Notepad) and macOS comes with [TextEdit](https://en.wikipedia.org/wiki/TextEdit). Linux distros vary; the Ubuntu 22.04 LTS release comes with [GNOME Text Editor](https://en.wikipedia.org/wiki/GNOME_Text_Editor) by default. Default OS plain text editors can be OK, but they also have a limited feature set.
Expand Down Expand Up @@ -87,8 +87,8 @@ Let's try an exercise in VS Code:

VS Code provides other syntax features too. For example:

- You'll see a thin vertical line travelling down from the `function` keyword to the closing curly brace (`}`) — these lines are used to mark different [indentation](https://en.wikipedia.org/wiki/Indentation_style) levels in code, making it easier to identify where blocks begin and end.
- Also try moving the flashing text cursor over the opening or closing curly brace (`{` or `}`) — you'll see both of them highlighted. This also helps identify the start and end of blocks, and is useful when are trying to find where you are missing a character when you have a more complicated structure with lots of nested blocks. This highlighting also works with other delimeters such as parentheses (`(` and `)`) and square brackets (`[` and `]`).
- You'll see a thin vertical line traveling down from the `function` keyword to the closing curly brace (`}`) — these lines are used to mark different [indentation](https://en.wikipedia.org/wiki/Indentation_style) levels in code, making it easier to identify where blocks begin and end.
- Also try moving the flashing text cursor over the opening or closing curly brace (`{` or `}`) — you'll see both of them highlighted. This also helps identify the start and end of blocks, and is useful when are trying to find where you are missing a character when you have a more complicated structure with lots of nested blocks. This highlighting also works with other delimiters such as parentheses (`(` and `)`) and square brackets (`[` and `]`).

### Code completion/suggestion

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ For now, we would recommend that you install [Visual Studio Code](https://code.v
Having modern web browsers available to you is essential for web development so that you can test your websites or apps on the browsers your visitors use to access them. You also need to keep your web browsers up-to-date so that they support the latest web technologies and have the latest security fixes applied.

> [!NOTE]
> Most browswers tend to install updates automatically, applying the changes when they are restarted. You can usually check for updates on the browser "About" page, for example available in the menu at _Firefox_ > _About Firefox_ or _Chrome_ > _About Google Chrome_ on Firefox/Chrome for macOS, or the menu icon > _Help_ > _About Firefox_ or menu icon > _Help_ > _About Google Chrome_ on Firefox/Chrome for Windows.
> Most browsers tend to install updates automatically, applying the changes when they are restarted. You can usually check for updates on the browser "About" page, for example available in the menu at _Firefox_ > _About Firefox_ or _Chrome_ > _About Google Chrome_ on Firefox/Chrome for macOS, or the menu icon > _Help_ > _About Firefox_ or menu icon > _Help_ > _About Google Chrome_ on Firefox/Chrome for Windows.
For now, you should install a couple of desktop and mobile/alternative device browsers to test your code in. You'll most commonly come across web browsers on desktop, laptop, and mobile devices, but you will also come across web browsers on other devices such as tablets, watches, and TVs. If possible, make sure you have one browser from each line installed and available to test on (so you don't just test in multiple browsers based on the same rendering engine):

Expand Down Expand Up @@ -71,7 +71,7 @@ One of the easiest options we've found to make a local server available is to us
4. Press the _Install_ button to install the extension.
5. Now, when you are working on an HTML file in the editor, you should be able to click the "Show Preview" button to open the live example up in a separate tab.

The above option is simple, but not that flexible. In future, you may want to made a more flexible local server option available that can be used to load examples in any browser you have available. For other options (and more background information around why local servers are neccessary), see [How do you set up a local testing server?](/en-US/docs/Learn_web_development/Howto/Tools_and_setup/set_up_a_local_testing_server).
The above option is simple, but not that flexible. In future, you may want to made a more flexible local server option available that can be used to load examples in any browser you have available. For other options (and more background information around why local servers are necessary), see [How do you set up a local testing server?](/en-US/docs/Learn_web_development/Howto/Tools_and_setup/set_up_a_local_testing_server).

## Graphics editors

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ The `"declarativeNetRequestFeedback"` permission is required to use {{WebExtAPIR
The declarative rules are defined by four fields:

- `id` – An ID that uniquely identifies a rule within a ruleset. Mandatory and should be >= 1.
- `priority` – The rule priority. When specified, it should be >= 1. Defaults to 1. See [Matching precedents](#matching_precedents) for details on how priority affects which rules are applied.
- `priority` – The rule priority. When specified, it should be >= 1. Defaults to 1. See [Matching precedence](#matching_precedence) for details on how priority affects which rules are applied.
- `condition` – The {{WebExtAPIRef("declarativeNetRequest.RuleCondition","condition")}} under which this rule is triggered.
- `action` – The {{WebExtAPIRef("declarativeNetRequest.RuleAction","action")}} to take when the rule is matched. Rules can do one of these things:
- block a network request.
Expand Down Expand Up @@ -115,7 +115,7 @@ The number of dynamic and session-scoped rules an extension can add is limited t
- In Safari and up to Chrome 119 and Firefox 127, the value of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES","MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES")}}.
- From Chrome 120 and Firefox 128, the values of {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_DYNAMIC_RULES","MAX_NUMBER_OF_DYNAMIC_RULES")}} and {{WebExtAPIRef("declarativeNetRequest.MAX_NUMBER_OF_SESSION_RULES","MAX_NUMBER_OF_SESSION_RULES")}}

## Matching precedents
## Matching precedence

When the browser evaluates how to handle requests, it checks each extension's rules that have a condition that matches the request and chooses the one to consider applying as follows:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The request or response header to modify for a request, declared in the `rule.ac

Each object describes one header modification. To modify multiple headers, multiple objects can be specified in these arrays, or across multiple rules.

Matching `modifyHeaders` rules are applied in the order described at [Matching precedents](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedents).
Matching `modifyHeaders` rules are applied in the order described at [Matching precedence](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedence).
Within each extension, all `modifyHeaders` rules with a priority lower than or equal to matching `allow` or `allowAllRequests` rules are ignored.

If multiple `modifyHeaders` rules specify the same header, the resulting modification for the header is determined based on the priority of each rule and the operations specified:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Values of this type are objects. They contain these properties:
- `id`
- : `number`. An ID that uniquely identifies a rule within a ruleset. Mandatory and should be >= 1.
- `priority` {{optional_inline}}
- : `number`. Rule priority. Defaults to 1. When specified, should be >= 1. See [Matching precedents](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedents) for details on how priority affects which rules are applied.
- : `number`. Rule priority. Defaults to 1. When specified, should be >= 1. See [Matching precedence](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedence) for details on how priority affects which rules are applied.

{{WebExtExamples("h2")}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Values of this type are objects. They contain these properties:
- `responseHeaders` {{optional_inline}}
- : {{WebExtAPIRef("declarativeNetRequest.ModifyHeaderInfo")}}. The response headers to modify for the request. Only valid if `type` is `"modifyHeaders"`.
- `type`
- : A `string`. The type of action to perform. Possible values are `"block"`, `"redirect"`, `"allow"`, `"upgradeScheme"`, `"modifyHeaders"`, and `"allowAllRequests"`. The use of the `"redirect"` and `"modifyHeaders"` actions require [host permissions](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions) for the request and request initiator. The "block" and "upgradeScheme" actions also require host permissions unless the "declarativeNetRequest" permission is specified. Without these permissions, matching rules are ignored. See [Permissions at declarativeNetRequest](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#permissions) for more information. More details about the effects of rule actions are provided in [Matching precedents](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedents).
- : A `string`. The type of action to perform. Possible values are `"block"`, `"redirect"`, `"allow"`, `"upgradeScheme"`, `"modifyHeaders"`, and `"allowAllRequests"`. The use of the `"redirect"` and `"modifyHeaders"` actions require [host permissions](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions) for the request and request initiator. The "block" and "upgradeScheme" actions also require host permissions unless the "declarativeNetRequest" permission is specified. Without these permissions, matching rules are ignored. See [Permissions at declarativeNetRequest](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#permissions) for more information. More details about the effects of rule actions are provided in [Matching precedence](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest#matching_precedence).

{{WebExtExamples("h2")}}

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/130/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This article provides information about the changes in Firefox 130 that affect d
### HTML

- The [`name`](/en-US/docs/Web/HTML/Element/details#name) attribute of the `<details>` element now allows the grouping of `<details>` elements, where only one element within a group can be open at a time. This allows you to create an exclusive accordion without using JavaScript ([Firefox bug 1856460](https://bugzil.la/1856460) and [Firefox bug 1909613](https://bugzil.la/1909613)).
- The [`dir`](/en-US/docs/Web/HTML/Global_attributes/dir) and [`lang`](/en-US/docs/Web/HTML/Global_attributes/lang) [global attributes](/en-US/docs/Web/HTML/Global_attributes) now have improved inheritance, including how they work with [shadow DOM](/en-US/docs/Web/API/Web_components/Using_shadow_DOM#attribute_inheritance) ([Firefox bug 1876163](https://bugzil.la/1876163).
- The [`dir`](/en-US/docs/Web/HTML/Global_attributes/dir) and [`lang`](/en-US/docs/Web/HTML/Global_attributes/lang) [global attributes](/en-US/docs/Web/HTML/Global_attributes) now have improved inheritance, including how they work with [shadow DOM](/en-US/docs/Web/API/Web_components/Using_shadow_DOM#attribute_inheritance) ([Firefox bug 1876163](https://bugzil.la/1876163)).

### CSS

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/console/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ console.info("My first car was a", car, ". The object is:", someObject);
The output will look like this:

```plain
My first car was a Dodge Charger. The object is: {str:"Some text", id:5}
My first car was a Dodge Charger . The object is: {str:"Some text", id:5}
```

#### Using string substitutions
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/svgangle/unittype/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ browser-compat: api.SVGAngle.unitType

{{APIRef("SVG")}}

The **`unitType`** property of the {{domxref("SVGAngle")}} interface is one of the [unit type contants](/en-US/docs/Web/API/SVGAngle#constants) and represents the units in which this angle's value is expressed.
The **`unitType`** property of the {{domxref("SVGAngle")}} interface is one of the [unit type constants](/en-US/docs/Web/API/SVGAngle#constants) and represents the units in which this angle's value is expressed.

## Value

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/css/scroll-snap-align/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ browser-compat: css.properties.scroll-snap-align

{{CSSRef}}

The `scroll-snap-align` property specifies the box's snap position as an alignment of its [snap area](/en-US/docs/Glossary/Scroll_snap#snap_area) (as the alignment subject) within its snap container's snap port (as the alignment container).
The `scroll-snap-align` property specifies the box's snap position as an alignment of its [snap area](/en-US/docs/Glossary/Scroll_snap#snap_area) (as the {{glossary("alignment subject")}}) within its snap container's snap port (as the {{glossary("alignment container")}}).

{{EmbedInteractiveExample("pages/css/scroll-snap-align.html")}}

Expand Down
14 changes: 8 additions & 6 deletions files/en-us/web/css/writing-mode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ This property specifies the _block flow direction_, which is the direction in wh
writing-mode: horizontal-tb;
writing-mode: vertical-rl;
writing-mode: vertical-lr;
writing-mode: sideways-rl;
writing-mode: sideways-lr;

/* Global values */
writing-mode: inherit;
Expand All @@ -43,17 +45,17 @@ The `writing-mode` property is specified as one of the values listed below. The
- : For `ltr` scripts, content flows vertically from top to bottom. For `rtl` scripts, content flows vertically from bottom to top. All the glyphs, even those in vertical scripts, are set sideways toward the right.
- `sideways-lr`
- : For `ltr` scripts, content flows vertically from bottom to top. For `rtl` scripts, content flows vertically from top to bottom. All the glyphs, even those in vertical scripts, are set sideways toward the left.
- `lr`
- `lr` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `horizontal-tb` instead.
- `lr-tb`
- `lr-tb` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `horizontal-tb` instead.
- `rl`
- `rl` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `horizontal-tb` instead.
- `tb`
- `tb` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `vertical-lr` instead.
- `tb-lr`
- `tb-lr` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `vertical-lr` instead.
- `tb-rl`
- `tb-rl` {{Deprecated_Inline}}
- : Deprecated except for SVG1 documents. For CSS, use `vertical-rl` instead.

## Formal definition
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ async function* g3() {
yield* g2();
}

const gen = g4();
const gen = g3();

console.log(await gen.next()); // {value: "foo", done: false}
console.log(await gen.next()); // {value: "bar", done: false}
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/manifest/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ All members are optional in the specification, but some applications require som
{{ListSubpages("/en-US/docs/Web/Manifest")}}

> [!NOTE]
> The `dir`, `lang`, `iarc_rating_id`, and `note_taking` members are not implemented.
> The `dir`, `lang`, and `iarc_rating_id` members are not implemented.
## Example manifest

Expand Down
Loading

0 comments on commit d8885a4

Please sign in to comment.