Skip to content

Commit 7449143

Browse files
authored
curly -> straight apostrophes (mdn#16770)
* Replace curly apostrophes by regular apostrophes. Adding to mdn#16324. * fix a typo
1 parent bb75864 commit 7449143

File tree

10 files changed

+42
-42
lines changed

10 files changed

+42
-42
lines changed

files/en-us/web/html/element/input/number/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -419,7 +419,7 @@ After declaring a few variables, an event listener is added to the `button` to c
419419
420420
## Accessibility
421421

422-
The implicit [role](/en-US/docs/Web/Accessibility/ARIA/Roles) for the `<input type="number">` element is [`spinbutton`](/en-US/docs/Web/Accessibility/ARIA/Roles/spinbutton_role). If spinbutton is not an important feature for your form control, consider *not* using `type="number"`. Instead, use [`inputmode="numeric"`](/en-US/docs/Web/HTML/Global_attributes/inputmode) along with a [`pattern`](/en-US/docs/Web/HTML/Attributes/pattern) attribute that limits the characters to numbers and associated characters. With `<input type="number">`, there is a risk of users accidentally incrementing a number when theyre trying to do something else. Additionally, if users try to enter something thats not a number, theres no explicit feedback about what theyre doing wrong.
422+
The implicit [role](/en-US/docs/Web/Accessibility/ARIA/Roles) for the `<input type="number">` element is [`spinbutton`](/en-US/docs/Web/Accessibility/ARIA/Roles/spinbutton_role). If spinbutton is not an important feature for your form control, consider *not* using `type="number"`. Instead, use [`inputmode="numeric"`](/en-US/docs/Web/HTML/Global_attributes/inputmode) along with a [`pattern`](/en-US/docs/Web/HTML/Attributes/pattern) attribute that limits the characters to numbers and associated characters. With `<input type="number">`, there is a risk of users accidentally incrementing a number when they're trying to do something else. Additionally, if users try to enter something that's not a number, there's no explicit feedback about what they're doing wrong.
423423

424424
Also consider using the [`autocomplete`](/en-US/docs/Web/HTML/Attributes/autocomplete) attribute to help users complete forms more quickly and with fewer chances of errors. For example, to enable autofill on a zip code field, set `autocomplete="postal-code"`.
425425

files/en-us/web/html/element/source/index.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -80,12 +80,12 @@ This element includes the [global attributes](/en-US/docs/Web/HTML/Global_attrib
8080
- : The [MIME media type of the resource](/en-US/docs/Web/Media/Formats/Image_types), optionally with a [`codecs` parameter](/en-US/docs/Web/Media/Formats/codecs_parameter).
8181

8282
- {{htmlattrdef("src")}}
83-
- : Required if the `source` elements parent is an {{HTMLElement("audio")}} and {{HTMLElement("video")}} element, but not allowed if the `source` elements parent is a {{HTMLElement("picture")}} element.
83+
- : Required if the `source` element's parent is an {{HTMLElement("audio")}} and {{HTMLElement("video")}} element, but not allowed if the `source` element's parent is a {{HTMLElement("picture")}} element.
8484

8585
Address of the media resource.
8686

8787
- {{htmlattrdef("srcset")}}
88-
- : Required if the `source` elements parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` elements parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
88+
- : Required if the `source` element's parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` element's parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
8989

9090
A list of one or more strings, separated by commas, indicating a set of possible images represented by the source for the browser to use. Each string is composed of:
9191

@@ -96,22 +96,22 @@ This element includes the [global attributes](/en-US/docs/Web/HTML/Global_attrib
9696
Each string in the list must have at least a width descriptor or a pixel density descriptor to be valid. Among the list, there must be only one string containing the same tuple of width descriptor and pixel density descriptor. The browser chooses the most adequate image to display at a given point of time.
9797

9898
- {{htmlattrdef("sizes")}}
99-
- : Allowed if the `source` elements parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` elements parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
99+
- : Allowed if the `source` element's parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` element's parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
100100

101101
A list of source sizes that describes the final rendered width of the image represented by the source. Each source size consists of a comma-separated list of media condition-length pairs. This information is used by the browser to determine, before laying the page out, which image defined in {{htmlattrxref("srcset", "source")}} to use. Please note that `sizes` will have its effect only if width dimension descriptors are provided with `srcset` instead of pixel ratio values (200w instead of 2x for example).
102102

103103
- {{htmlattrdef("media")}}
104-
- : Allowed if the `source` elements parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` elements parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
104+
- : Allowed if the `source` element's parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` element's parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
105105

106106
[Media query](/en-US/docs/Web/CSS/Media_Queries) of the resource's intended media.
107107

108108
- {{htmlattrdef("height")}}
109-
- : Allowed if the `source` elements parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` elements parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
109+
- : Allowed if the `source` element's parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` element's parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
110110

111111
The intrinsic height of the image, in pixels. Must be an integer without a unit.
112112

113113
- {{htmlattrdef("width")}}
114-
- : Allowed if the `source` elements parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` elements parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
114+
- : Allowed if the `source` element's parent is a {{HTMLElement("picture")}} element, but not allowed if the `source` element's parent is an {{HTMLElement("audio")}} or {{HTMLElement("video")}} element.
115115

116116
The intrinsic width of the image in pixels. Must be an integer without a unit.
117117

files/en-us/web/http/basics_of_http/mime_types/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,7 @@ Per the current relevant standards, JavaScript content should always be served u
156156
No other MIME types are considered valid for JavaScript, and using any MIME type other than`text/javascript` may result in scripts that do not load or run.
157157

158158
You may find some JavaScript content incorrectly served with a `charset` parameter as part of the MIME type — as an attempt to specify the character set for the script content.
159-
That `charset` parameter isnt valid for JavaScript content, and in most cases will result in a script failing to load.
159+
That `charset` parameter isn't valid for JavaScript content, and in most cases will result in a script failing to load.
160160

161161
#### Legacy JavaScript MIME types
162162

files/en-us/web/http/caching/index.md

+15-15
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Personalized contents are usually controlled by cookies, but the presence of a c
3939

4040
Also, since the private cache requires `private`, you may think that the shared cache requires `public` — but that is not quite true. A shared cache will store a response without needing `public` as long as `max-age` is given.
4141

42-
If the response has an `Authorization` header, it cannot be stored in either the private cache or the shared cache, even if it has `max-age` — and `public` can be used to allow such a case. But if you are not using basic authentication and do not have an `Authorization` header, then there is no need to add `public`; its just a waste of bytes in that case.
42+
If the response has an `Authorization` header, it cannot be stored in either the private cache or the shared cache, even if it has `max-age` — and `public` can be used to allow such a case. But if you are not using basic authentication and do not have an `Authorization` header, then there is no need to add `public`; it's just a waste of bytes in that case.
4343

4444
### Shared cache
4545

@@ -75,7 +75,7 @@ Cache-Control: no-store
7575

7676
For example, Varnish uses VCL-based logic to handle cache storage, while service workers in combination with the Cache API allow you to create that logic in JavaScript.
7777

78-
That means if a managed cache intentionally ignores a `no-store` directive, there is no need to perceive it as being "non-compliant" with the standard. What you should do is, avoid using kitchen-sink headers, but carefully read the documentation of whatever managed-cache mechanism youre using, and ensure youre controlling the cache properly in the ways provided by the mechanism youve chosen to use.
78+
That means if a managed cache intentionally ignores a `no-store` directive, there is no need to perceive it as being "non-compliant" with the standard. What you should do is, avoid using kitchen-sink headers, but carefully read the documentation of whatever managed-cache mechanism you're using, and ensure you're controlling the cache properly in the ways provided by the mechanism you've chosen to use.
7979

8080
Note that some CDNs provide their own headers that are effective only for that CDN (for example, `Surrogate-Control`). Currently, work is underway to define a [`CDN-Cache-Control`](https://datatracker.ietf.org/doc/html/draft-ietf-httpbis-targeted-cache-control) header to standardize those.
8181

@@ -208,7 +208,7 @@ If-Modified-Since: Tue, 22 Feb 2022 22:00:00 GMT
208208

209209
The server will respond with `304 Not Modified` if the content has not changed since the specified time.
210210

211-
Since this response only indicates "no change", there is no response body — instead theres just a status code — so the transfer size is extremely small.
211+
Since this response only indicates "no change", there is no response body — instead there's just a status code — so the transfer size is extremely small.
212212

213213
```http
214214
HTTP/1.1 304 Not Modified
@@ -290,13 +290,13 @@ Cache-Control: max-age=0, must-revalidate
290290

291291
However, that usage of `max-age=0` is a remnant of the fact that many implementations prior to HTTP/1.1 were unable to handle the `no-cache` directive — and so to deal with that limitation, `max-age=0` was used as a workaround.
292292

293-
But now that HTTP/1.1-conformant servers are widely deployed, theres no reason to ever use that `max-age=0`-and-`must-revalidate` combination — you should instead just use `no-cache`.
293+
But now that HTTP/1.1-conformant servers are widely deployed, there's no reason to ever use that `max-age=0`-and-`must-revalidate` combination — you should instead just use `no-cache`.
294294

295295
## Don't cache
296296

297297
The `no-cache` directive does not prevent storage of responses, but instead prevents reuse of responses without revalidation.
298298

299-
If you dont want a response stored in any cache, use `no-store`.
299+
If you don't want a response stored in any cache, use `no-store`.
300300

301301
```http
302302
Cache-Control: no-store
@@ -358,7 +358,7 @@ Cache-Control: no-cache, private
358358

359359
You may think adding `no-store` would be the right way to opt out from caching.
360360

361-
However, its basically not recommended to grant `no-store` easily, because you lose many advantages that HTTP and browsers have, including the browsers back/forward cache.
361+
However, it's basically not recommended to grant `no-store` easily, because you lose many advantages that HTTP and browsers have, including the browser's back/forward cache.
362362

363363
Therefore, to get the advantages of the full feature set of the web platform, prefer the use of `no-cache` in combination with `private`.
364364

@@ -410,7 +410,7 @@ Cache-Control: no-cache
410410

411411
(The requests from Chrome, Edge, and Firefox look very much like the above; the requests from Safari will look a bit different.)
412412

413-
Since thats not a conditional request with `no-cache`, you can be sure youll get a `200 OK` from the origin server.
413+
Since that's not a conditional request with `no-cache`, you can be sure you'll get a `200 OK` from the origin server.
414414

415415
That behavior is also defined in the [Fetch](https://fetch.spec.whatwg.org/#http-network-or-cache-fetch) standard and can be reproduced in JavaScript by calling `fetch()` with the cache mode set to `reload` (note that it's not `force-reload`):
416416

@@ -455,7 +455,7 @@ You may want to overwrite that response once it expired on the server, but there
455455

456456
One of the methods mentioned in the specification is to send a request for the same URL with an unsafe method such as `POST` — but that is usually difficult to do so intentionally in many clients.
457457

458-
There is also a specification for a `Clear-Site-Data: cache` header and value, but [not all browsers support it](https://groups.google.com/a/mozilla.org/g/dev-platform/c/I939w1yrTp4) — and even when its used, it is only affects browser caches, but has no effect on intermediate caches.
458+
There is also a specification for a `Clear-Site-Data: cache` header and value, but [not all browsers support it](https://groups.google.com/a/mozilla.org/g/dev-platform/c/I939w1yrTp4) — and even when it's used, it is only affects browser caches, but has no effect on intermediate caches.
459459

460460
Therefore, it should be assumed that any stored response will remain for its `max-age` period unless the user manually performs a reload, force reload, or clear-history action.
461461

@@ -483,9 +483,9 @@ This section describes the common patterns in designing caches.
483483

484484
As mentioned above, the default behavior for caching (that is, for a response without `Cache-Control`) is not simply "don't cache" but implicit caching according to so-called "heuristic caching".
485485

486-
To avoid that heuristic caching, its preferable to explicitly give all responses a default `Cache-Control` header.
486+
To avoid that heuristic caching, it's preferable to explicitly give all responses a default `Cache-Control` header.
487487

488-
To ensure that by default the latest versions of resources will always be transferred, its common practice to make the default `Cache-Control` value include `no-cache`:
488+
To ensure that by default the latest versions of resources will always be transferred, it's common practice to make the default `Cache-Control` value include `no-cache`:
489489

490490
```http
491491
Cache-Control: no-cache
@@ -578,7 +578,7 @@ Cache-Control: max-age=2592000
578578

579579
### Validation
580580

581-
Don't forget to set the `If-Modified-Since` and `ETag` headers, so that you don't have to re-transmit a resource when reloading. Its easy to generate those headers for pre-built static files.
581+
Don't forget to set the `If-Modified-Since` and `ETag` headers, so that you don't have to re-transmit a resource when reloading. It's easy to generate those headers for pre-built static files.
582582

583583
The `ETag` value here may be a hash of the file.
584584

@@ -605,7 +605,7 @@ ETag: YsAIAAAA-QG4G6kCMAMBAAAAAAAoK
605605
Making a response cacheable over a long period of time by changing the URL when the content changes is called **cache busting**. That technique can be applied to all subresources, such as images.
606606

607607
> **Note:** When evaluating the use of `immutable` and QPACK:
608-
> If youre concerned that `immutable` changes the predefined value provided by QPACK, consider that
608+
> If you're concerned that `immutable` changes the predefined value provided by QPACK, consider that
609609
> in this case, the `immutable` part can be encoded separately by splitting the `Cache-Control` value into two lines — though this is dependent on the encoding algorithm a particular QPACK implementation uses.
610610
611611
```http
@@ -640,7 +640,7 @@ If-Modified-Since: Tue, 22 Feb 2022 20:20:20 GMT
640640
ETag: AAPuIbAOdvAGEETbgAAAAAAABAAE
641641
```
642642

643-
That setting is appropriate for non-personalized HTML — but for a response which gets personalized using cookies (for example, after a login), dont forget to also specify `private`:
643+
That setting is appropriate for non-personalized HTML — but for a response which gets personalized using cookies (for example, after a login), don't forget to also specify `private`:
644644

645645
```http
646646
200 OK HTTP/1.1
@@ -658,9 +658,9 @@ Most web content can be covered by a combination of the two patterns described a
658658

659659
### More about managed caches
660660

661-
With the method described in previous sections, subresources can be cached for a long time by using cache busting, but main resources (which are usually HTML documents) cant be.
661+
With the method described in previous sections, subresources can be cached for a long time by using cache busting, but main resources (which are usually HTML documents) can't be.
662662

663-
Caching main resources is difficult because, using just standard directives from the HTTP Caching specification, theres no way to actively delete cache contents when content is updated on the server.
663+
Caching main resources is difficult because, using just standard directives from the HTTP Caching specification, there's no way to actively delete cache contents when content is updated on the server.
664664

665665
However, it is possible by deploying a managed cache such as a CDN or service worker.
666666

files/en-us/web/http/headers/x-forwarded-for/index.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The **`X-Forwarded-For`** (XFF) request header is a de-facto standard header for
1818
When a client connects directly to a server, the
1919
client's IP address is sent to the server (and is often written to server
2020
access logs). But if a client connection passes through any [forward or reverse](https://en.wikipedia.org/wiki/Proxy_server) proxies, the server only
21-
sees the final proxy's IP address, which is often of little use. Thats especially true if
21+
sees the final proxy's IP address, which is often of little use. That's especially true if
2222
the final proxy is a load balancer which is part of the same installation
2323
as the server. So, to provide a more-useful client IP address to the server, the `X-Forwarded-For` request header is
2424
used.
@@ -48,13 +48,13 @@ header.
4848

4949
The `X-Forwarded-For` header is untrustworthy when no trusted reverse proxy (e.g., a load balancer) is between the client and
5050
server. If the client and all proxies are benign and well-behaved, then the list of IP addresses in the header
51-
has the meaning described in the [Directives](#directives) section. But if theres a risk the client or any proxy
52-
is malicious or misconfigured, then its possible any part (or the entirety) of the header may have been
51+
has the meaning described in the [Directives](#directives) section. But if there's a risk the client or any proxy
52+
is malicious or misconfigured, then it's possible any part (or the entirety) of the header may have been
5353
spoofed (and may not be a list or contain IP addresses at all).
5454

5555
If any trusted reverse proxies are between the client and
5656
server, the final `X-Forwarded-For` IP addresses (one for each trusted proxy) are trustworthy, as they
57-
were added by trusted proxies. (Thats true as long as the server is _only_
57+
were added by trusted proxies. (That's true as long as the server is _only_
5858
accessible through those proxies and not also directly).
5959

6060
Any security-related use of `X-Forwarded-For` (such as for rate limiting or IP-based

0 commit comments

Comments
 (0)