Skip to content

Commit

Permalink
chore(http): delete "Basics of HTTP" page in favor of HTTP landing pa…
Browse files Browse the repository at this point in the history 
…ge, reorganize index (#35774)

* chore(http): link HTTP resources in root page, remove 'basics' page

* chore(http): Remove 'basics of HTTP' page in favor of landing page

* chore(http): Add proxies and tunnels doc

* chore(http): Add proxies and tunnels doc

* Update files/en-us/web/http/index.md

Co-authored-by: Joshua Chen <[email protected]>

* chore(http): Changes following reviewer feedback

---------

Co-authored-by: Joshua Chen <[email protected]>
  • Loading branch information
@bsmth @Josh-Cena
bsmth and Josh-Cena authored Oct 1, 2024
1 parent d2dfabf commit f75b2c8
Show file tree
Hide file tree
Showing 52 changed files with 279 additions and 250 deletions.
13 changes: 8 additions & 5 deletions files/en-us/_redirects.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4000,7 +4000,7 @@
/en-US/docs/Inbox/Advanced_layouts_with_flexbox /en-US/docs/Glossary/Flexbox
/en-US/docs/Inbox/Using_flexbox_to_lay_out_web_applications /en-US/docs/Web/CSS/CSS_flexible_box_layout/Typical_use_cases_of_flexbox
/en-US/docs/Inbox/Writing_a_WebSocket_server_in_Java /en-US/docs/Web/API/WebSockets_API/Writing_a_WebSocket_server_in_Java
/en-US/docs/Incorrect_MIME_Type_for_CSS_Files /en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types
/en-US/docs/Incorrect_MIME_Type_for_CSS_Files /en-US/docs/Web/HTTP/MIME_types
/en-US/docs/IndexedDB /en-US/docs/Web/API/IndexedDB_API
/en-US/docs/IndexedDB/Basic_Concepts_Behind_IndexedDB /en-US/docs/Web/API/IndexedDB_API/Basic_Terminology
/en-US/docs/IndexedDB/Cursor /en-US/docs/Web/API/IDBCursor
Expand Down Expand Up @@ -12286,18 +12286,21 @@
/en-US/docs/Web/HTML/element/content /en-US/docs/Web/HTML/element/slot
/en-US/docs/Web/HTTP/Access_control_CORS /en-US/docs/Web/HTTP/CORS
/en-US/docs/Web/HTTP/Basic_access_authentication /en-US/docs/Web/HTTP/Authentication
/en-US/docs/Web/HTTP/Basics_of_HTTP /en-US/docs/Web/HTTP
/en-US/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs /en-US/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /en-US/docs/Web/URI/Schemes/data
/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs /en-US/docs/Web/URI/Schemes/data
/en-US/docs/Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP /en-US/docs/Web/HTTP/Evolution_of_HTTP
/en-US/docs/Web/HTTP/Basics_of_HTTP/Introduction_to_www_and_non-www_URLs /en-US/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types /en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types /en-US/docs/Web/HTTP/MIME_types
/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types /en-US/docs/Web/HTTP/MIME_types/Common_types
/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types /en-US/docs/Web/HTTP/MIME_types/Common_types
/en-US/docs/Web/HTTP/Basics_of_HTTP/Resource_URLs /en-US/docs/Web/URI/Schemes/resource
/en-US/docs/Web/HTTP/CORS/Errors/Reason:_CORS_header_‘Origin’_cannot_be_added /en-US/docs/Web/HTTP/CORS/Errors/CORSOriginHeaderNotAdded
/en-US/docs/Web/HTTP/Caching_FAQ /en-US/docs/Web/HTTP/Caching
/en-US/docs/Web/HTTP/Controlling_DNS_prefetching /en-US/docs/Web/HTTP/Headers/X-DNS-Prefetch-Control
/en-US/docs/Web/HTTP/Cookies/Cookie_Prefixes /en-US/docs/Web/HTTP/Cookies#Cookie_prefixes
/en-US/docs/Web/HTTP/Cross-Origin_Resource_Policy_(CORP) /en-US/docs/Web/HTTP/Cross-Origin_Resource_Policy
/en-US/docs/Web/HTTP/Evolution_of_HTTP /en-US/docs/Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP
/en-US/docs/Web/HTTP/Feature_Policy /en-US/docs/Web/HTTP/Permissions_Policy
/en-US/docs/Web/HTTP/Gecko_user_agent_string_reference /en-US/docs/Web/HTTP/Headers/User-Agent/Firefox
/en-US/docs/Web/HTTP/HTTP_response_codes /en-US/docs/Web/HTTP/Status
Expand Down Expand Up @@ -12351,13 +12354,13 @@
/en-US/docs/Web/HTTP/Headers/Ranges /en-US/docs/Web/HTTP/Headers/Range
/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite /en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value
/en-US/docs/Web/HTTP/Headers/Set-Cookie2 /en-US/docs/Web/HTTP/Headers/Set-Cookie
/en-US/docs/Web/HTTP/History_of_HTTP_versions /en-US/docs/Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP
/en-US/docs/Web/HTTP/History_of_HTTP_versions /en-US/docs/Web/HTTP/Evolution_of_HTTP
/en-US/docs/Web/HTTP/Index /en-US/docs/Web/HTTP
/en-US/docs/Web/HTTP/Link_prefetching_FAQ /en-US/docs/Glossary/Prefetch
/en-US/docs/Web/HTTP/Pipelining_FAQ /en-US/docs/Web/HTTP/Connection_management_in_HTTP_1.x
/en-US/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file /en-US/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_PAC_file
/en-US/docs/Web/HTTP/Public_Key_Pinning /en-US/docs/Web/Security/Certificate_Transparency
/en-US/docs/Web/HTTP/Resources_and_URIs /en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types
/en-US/docs/Web/HTTP/Resources_and_URIs /en-US/docs/Web/HTTP/MIME_types
/en-US/docs/Web/HTTP/Response_codes /en-US/docs/Web/HTTP/Status
/en-US/docs/Web/HTTP/Server-Side_Access_Control /en-US/docs/Web/HTTP/CORS
/en-US/docs/Web/HTTP/Status/416_Range_Not_Satisfiable /en-US/docs/Web/HTTP/Status/416
Expand Down
202 changes: 93 additions & 109 deletions files/en-us/_wikihistory.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -98403,115 +98403,6 @@
"teoli"
]
},
"Web/HTTP/Basics_of_HTTP": {
"modified": "2020-09-30T16:56:11.613Z",
"contributors": [
"firstnamelastname",
"chrisdavidmills",
"frattinijulien29",
"lbd1607",
"mfuji09",
"ExE-Boss",
"funghorn",
"BunnyWong",
"cissoid",
"teoli",
"fscholz"
]
},
"Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP": {
"modified": "2020-09-25T15:02:32.165Z",
"contributors": [
"mfuji09",
"darby",
"VitalyKrenel",
"Sgeo",
"ivnl",
"ExE-Boss",
"chrisdavidmills",
"zhaoyingdu",
"maruhgar",
"BunnyWong",
"rileym7",
"stephaniehobson",
"Yonkai",
"xcoderreal",
"fscholz",
"Cameron-Riecan",
"david_ross",
"DarrenLester",
"teoli"
]
},
"Web/HTTP/Basics_of_HTTP/MIME_types": {
"modified": "2019-11-03T12:37:56.527Z",
"contributors": [
"mfuji09",
"Sheppy",
"Alhadis",
"awwright",
"sideshowbarker",
"ExE-Boss",
"Dzonny",
"Tigt",
"tribak",
"amitgupta15",
"nakkurt",
"MicroJes",
"snuggs",
"d4nyll",
"xgqfrms-GitHub",
"dawsonbotsford",
"g-patel",
"strattadb",
"david_ross",
"DJ-Leith",
"teoli",
"fscholz"
]
},
"Web/HTTP/Basics_of_HTTP/MIME_types/Common_types": {
"modified": "2020-05-01T18:32:40.232Z",
"contributors": [
"broofa",
"sideshowbarker",
"chrisdavidmills",
"charj",
"SphinxKnight",
"mathiasbynens",
"Dorward",
"igorskyflyer",
"rctgamer3",
"mfuji09",
"Coder-Arjun",
"joeyparrish",
"devex23",
"ignaloidas",
"aadityataparia",
"dunglas",
"gabriele.bernuzzi",
"evilpie",
"xiaopanke",
"Loadmaster",
"iamakidilam",
"snuggs",
"Sheppy",
"Thw0rted",
"Krenair",
"Vikaash",
"Naesten",
"dave.shaheen",
"alettieri",
"NaveenDA",
"AbsoluteZERO",
"BrienA",
"kyrylkov",
"choury",
"david_ross",
"fscholz",
"teoli"
]
},
"Web/HTTP/Browser_detection_using_the_user_agent": {
"modified": "2020-07-11T11:53:53.804Z",
"contributors": [
Expand Down Expand Up @@ -99034,6 +98925,30 @@
"fscholz"
]
},
"Web/HTTP/Evolution_of_HTTP": {
"modified": "2020-09-25T15:02:32.165Z",
"contributors": [
"mfuji09",
"darby",
"VitalyKrenel",
"Sgeo",
"ivnl",
"ExE-Boss",
"chrisdavidmills",
"zhaoyingdu",
"maruhgar",
"BunnyWong",
"rileym7",
"stephaniehobson",
"Yonkai",
"xcoderreal",
"fscholz",
"Cameron-Riecan",
"david_ross",
"DarrenLester",
"teoli"
]
},
"Web/HTTP/Headers": {
"modified": "2020-11-16T08:22:37.817Z",
"contributors": [
Expand Down Expand Up @@ -100462,6 +100377,75 @@
"fscholz"
]
},
"Web/HTTP/MIME_types": {
"modified": "2019-11-03T12:37:56.527Z",
"contributors": [
"mfuji09",
"Sheppy",
"Alhadis",
"awwright",
"sideshowbarker",
"ExE-Boss",
"Dzonny",
"Tigt",
"tribak",
"amitgupta15",
"nakkurt",
"MicroJes",
"snuggs",
"d4nyll",
"xgqfrms-GitHub",
"dawsonbotsford",
"g-patel",
"strattadb",
"david_ross",
"DJ-Leith",
"teoli",
"fscholz"
]
},
"Web/HTTP/MIME_types/Common_types": {
"modified": "2020-05-01T18:32:40.232Z",
"contributors": [
"broofa",
"sideshowbarker",
"chrisdavidmills",
"charj",
"SphinxKnight",
"mathiasbynens",
"Dorward",
"igorskyflyer",
"rctgamer3",
"mfuji09",
"Coder-Arjun",
"joeyparrish",
"devex23",
"ignaloidas",
"aadityataparia",
"dunglas",
"gabriele.bernuzzi",
"evilpie",
"xiaopanke",
"Loadmaster",
"iamakidilam",
"snuggs",
"Sheppy",
"Thw0rted",
"Krenair",
"Vikaash",
"Naesten",
"dave.shaheen",
"alettieri",
"NaveenDA",
"AbsoluteZERO",
"BrienA",
"kyrylkov",
"choury",
"david_ross",
"fscholz",
"teoli"
]
},
"Web/HTTP/Messages": {
"modified": "2020-12-03T23:53:07.614Z",
"contributors": [
Expand Down
8 changes: 5 additions & 3 deletions files/en-us/glossary/http_2/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,13 @@ page-type: glossary-definition

{{GlossarySidebar}}

**HTTP/2** is a major revision of the [HTTP network protocol](/en-US/docs/Web/HTTP/Basics_of_HTTP).
**HTTP/2** is a major revision of the [HTTP network protocol](/en-US/docs/Web/HTTP).

The primary goals for HTTP/2 are to reduce {{glossary("latency")}} by enabling full request and response multiplexing, minimize protocol overhead via efficient compression of HTTP header fields, and add support for request prioritization and server push.
The primary goals for HTTP/2 are to reduce {{glossary("latency")}} and head-of-line blocking by enabling full request and response multiplexing, minimize protocol overhead via efficient compression of HTTP header fields, and add support for request prioritization and server push.

HTTP/2 does not modify the application semantics of HTTP in any way. All the core concepts found in HTTP 1.1, such as HTTP methods, status codes, URIs, and header fields, remain in place. Instead, HTTP/2 modifies how the data is formatted (framed) and transported between the client and server, both of which manage the entire process, and hides application complexity within the new framing layer. As a result, all existing applications can be delivered without modification.
HTTP/2 does not modify the semantics of HTTP, meaning the core concepts found in HTTP/1.1, such as methods, status codes, URIs, and header fields, remain the same.
Instead, HTTP/2 modifies how the data is formatted (framed) and transported between the client and server, both of which manage the entire process, and hides protocol complexity within a framing layer.
As a result, all existing applications can be delivered over the protocol without modification.

## See also

Expand Down
6 changes: 3 additions & 3 deletions files/en-us/glossary/http_3/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@ page-type: glossary-definition

{{GlossarySidebar}}

**HTTP/3** is the upcoming major revision of the [HTTP network protocol](/en-US/docs/Web/HTTP/Basics_of_HTTP), succeeding {{glossary("HTTP 2", "HTTP/2")}}.
**HTTP/3** is a major revision of the [HTTP network protocol](/en-US/docs/Web/HTTP), succeeding {{glossary("HTTP 2", "HTTP/2")}}.

The major point of HTTP/3 is that it uses a new {{glossary("UDP")}} protocol named QUIC, instead of {{glossary("TCP")}}.
The most notable difference in HTTP/3 is that it uses a protocol named QUIC over {{glossary("UDP")}} instead of {{glossary("TCP")}}.

## See also

- [HTTP on MDN](/en-US/docs/Web/HTTP)
- [HTTP documentation](/en-US/docs/Web/HTTP)
- [HTTP/3](https://en.wikipedia.org/wiki/HTTP/3) on Wikipedia
- Related glossary terms:
- {{glossary("HTTP")}}
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/glossary/lossy_compression/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ page-type: glossary-definition

**Lossy compression**, or irreversible compression, is a data-compression method that uses inexact approximations and partial-data discarding to represent content. In simpler terms: lossy compression causes data from the initial file to be lost, possibly causing degradation in quality. The process of such compression is irreversible; once lossy compression of the content has been performed, the content cannot be restored to its original state. Therefore, content that has undergone lossy compression should generally not be further edited.

Lossy compression is widely used in image formats such as {{glossary("JPEG")}}, {{glossary("WebP")}}, and audio and video formats such as [MP3, MP4, H.264 and others](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types).
Lossy compression is widely used in image formats such as {{glossary("JPEG")}}, {{glossary("WebP")}}, and audio and video formats such as [MP3, MP4, H.264 and others](/en-US/docs/Web/HTTP/MIME_types/Common_types).
Compression methods such as {{glossary("WebP")}} are capable of [both lossy and lossless compression](https://developers.google.com/speed/webp/docs/compression) depending on the compression level or the options you want to use during encoding.

![Lossy compression image](2019-11-18.png)
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/glossary/mime_type/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ The name originates from the {{glossary("mime","MIME")}} standard originally use
- [Internet media type](https://en.wikipedia.org/wiki/Internet_media_type) on Wikipedia
- [List of MIME types](https://www.iana.org/assignments/media-types/media-types.xhtml)
- [Properly Configuring Server MIME Types](/en-US/docs/Learn/Server-side/Configuring_server_MIME_types)
- Details information about the usage of [MIME Types](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in a Web context.
- [Incomplete list of MIME types](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types)
- Details information about the usage of [MIME Types](/en-US/docs/Web/HTTP/MIME_types) in a Web context.
- [Incomplete list of MIME types](/en-US/docs/Web/HTTP/MIME_types/Common_types)
- [MediaRecorder.mimeType](/en-US/docs/Web/API/MediaRecorder/mimeType)
2 changes: 1 addition & 1 deletion files/en-us/learn/forms/sending_and_retrieving_form_data/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Once the form data has been validated on the client-side, it is okay to submit t
<a href="/en-US/docs/Learn/HTML/Introduction_to_HTML"
>understanding of HTML</a
>, and basic knowledge of
<a href="/en-US/docs/Web/HTTP/Basics_of_HTTP">HTTP</a> and
<a href="/en-US/docs/Web/HTTP">HTTP</a> and
<a href="/en-US/docs/Learn/Server-side/First_steps"
>server-side programming</a
>.
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/learn/getting_started_with_the_web/the_web_and_web_standards/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ You are probably reading these words inside a web browser in this very moment (u

### HTTP

Hypertext Transfer Protocol, or [HTTP](/en-US/docs/Web/HTTP/Basics_of_HTTP), is a messaging protocol that allows web browsers to communicate with web servers (where websites are stored). A typical conversation goes something like
Hypertext Transfer Protocol, or [HTTP](/en-US/docs/Web/HTTP), is a messaging protocol that allows web browsers to communicate with web servers (where websites are stored). A typical conversation goes something like

```plain
"Hello web server. Can you give me the files I need to render bbc.co.uk"?
Expand Down
4 changes: 2 additions & 2 deletions files/en-us/learn/server-side/configuring_server_mime_types/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ When looking for information about JavaScript MIME types, you may see several MI
While browsers may support any, some, or all of these alternative MIME types, you should **only** use `text/javascript` to indicate the MIME type of JavaScript files.

> [!NOTE]
> See [MIME types (IANA media types)](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) for more information.
> See [MIME types (IANA media types)](/en-US/docs/Web/HTTP/MIME_types) for more information.
## How to determine the MIME type to set

Expand Down Expand Up @@ -109,6 +109,6 @@ Trying to instead set it with just `header('application/pdf')` won't work.

- [IANA | MIME Media Types](https://www.iana.org/assignments/media-types/media-types.xhtml)
- [Hypertext Transfer Protocol — HTTP/1.1](https://www.w3.org/Protocols/rfc2616/rfc2616.html)
- [MIME types (IANA media types)](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types)
- [MIME types (IANA media types)](/en-US/docs/Web/HTTP/MIME_types)
- [Apache vs Nginx: Practical Considerations](https://www.digitalocean.com/community/tutorials/apache-vs-nginx-practical-considerations)
- [Migrate Apache .htaccess to Nginx server block](https://barryvanveen.nl/articles/56-migrate-apache-htaccess-to-nginx-server-block/)
2 changes: 1 addition & 1 deletion files/en-us/learn/server-side/node_server_without_framework/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ If the file can be served (the server process has access and no path-traversal v
Note that other status codes can be found in `http.STATUS_CODES`.
With `404` status we will return content of `'/404.html'` file.

The extension of the file being requested will be parsed and lower-cased. After that we will search `MIME_TYPES` collection for the right [MIME types](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types). If no matches are found, we use the `application/octet-stream` as the default type.
The extension of the file being requested will be parsed and lower-cased. After that we will search `MIME_TYPES` collection for the right [MIME types](/en-US/docs/Web/HTTP/MIME_types). If no matches are found, we use the `application/octet-stream` as the default type.

Finally, if there are no errors, we send the requested file. The `file.stream` will contain a `Readable` stream that will be piped into `res` (an instance of the `Writable` stream).

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/mozilla/firefox/releases/65/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ _No changes._
#### Fetch and Service workers

- The {{domxref("Response.redirect_static", "Response.redirect()")}} method now correctly throws a `TypeError` if a non-valid URL is specified as the first parameter ([Firefox bug 1503276](https://bugzil.la/1503276)).
- The {{domxref("ServiceWorkerContainer.register()")}} and {{domxref("WorkerGlobalScope.importScripts()")}} (when used by a service worker) methods will now accept any files with a valid [JavaScript MIME type](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types#textjavascript) ([Firefox bug 1354577](https://bugzil.la/1354577)).
- The {{domxref("ServiceWorkerContainer.register()")}} and {{domxref("WorkerGlobalScope.importScripts()")}} (when used by a service worker) methods will now accept any files with a valid [JavaScript MIME type](/en-US/docs/Web/HTTP/MIME_types#textjavascript) ([Firefox bug 1354577](https://bugzil.la/1354577)).
- The {{domxref("FetchEvent.replacesClientId")}} and {{domxref("FetchEvent.resultingClientId")}} properties are now supported ([Firefox bug 1264177](https://bugzil.la/1264177)).
- The {{domxref("ServiceWorkerGlobalScope.messageerror_event", "ServiceWorkerGlobalScope.onmessageerror")}} and {{domxref("ServiceWorkerContainer.messageerror_event", "ServiceWorkerContainer.onmessageerror")}} handler properties have been implemented ([Firefox bug 1399446](https://bugzil.la/1399446)).
- The {{httpheader("Origin")}} header is no longer set on Fetch requests with a method of {{HTTPMethod("HEAD")}} or {{HTTPMethod("GET")}} ([Firefox bug 1508661](https://bugzil.la/1508661)).
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/datatransferitem/type/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -61,4 +61,4 @@ function dropHandler(ev) {
## See also

- {{domxref("DataTransfer.types()")}}
- [List of common MIME types](/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types)
- [List of common MIME types](/en-US/docs/Web/HTTP/MIME_types/Common_types)
Loading

0 comments on commit f75b2c8

Please sign in to comment.