Skip to content

Commit

Permalink
Properly mark Warning HTTP-Header as deprecated (#11079)
Browse files Browse the repository at this point in the history
  • Loading branch information
DerZade authored Dec 9, 2021
1 parent 61baaf4 commit c71fd9d
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 24 deletions.
2 changes: 1 addition & 1 deletion files/en-us/web/http/headers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ Headers can also be grouped according to how {{Glossary("Proxy_server", "proxies
- : The date/time after which the response is considered stale.
- {{HTTPHeader("Pragma")}}
- : Implementation-specific header that may have various effects anywhere along the request-response chain. Used for backwards compatibility with HTTP/1.0 caches where the `Cache-Control` header is not yet present.
- {{HTTPHeader("Warning")}}
- {{HTTPHeader("Warning")}} {{deprecated_inline}}
- : General warning information about possible problems.

## Client hints
Expand Down
34 changes: 11 additions & 23 deletions files/en-us/web/http/headers/warning/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,17 @@ tags:
- HTTP Header
- Request header
- Response header
- Deprecated
- Reference
browser-compat: http.headers.Warning
---
{{HTTPSidebar}}
{{HTTPSidebar}} {{deprecated_header}}

> **Note:** The `Warning` header has been deprecated; see
> [Warning
> (https://github.com/httpwg/http-core/issues/139)](https://github.com/httpwg/http-core/issues/139) and [Warning: header &
> stale-while-revalidate (https://github.com/whatwg/fetch/issues/913)](https://github.com/whatwg/fetch/issues/913) for more
> details.
The **`Warning`** HTTP header contains information about possible problems with the status of the message.
More than one `Warning` header may appear in a response.

The **`Warning`** HTTP header contains information
about possible problems with the status of the message. More than one
`Warning` header may appear in a response.

`Warning` header fields can, in general, be applied to any message. However, some warn-codes are specific to caches and can only be applied to response messages.
`Warning` header fields can, in general, be applied to any message.
However, some warn-codes are specific to caches and can only be applied to response messages.

<table class="properties">
<tbody>
Expand Down Expand Up @@ -49,24 +44,17 @@ Warning: <warn-code> <warn-agent> <warn-text> [<warn-date>]

- \<warn-code>

- : A three-digit warning number. The first digit indicates whether the
`Warning` is required to be deleted from a stored response after
validation.
- : A three-digit warning number. The first digit indicates whether the `Warning` is required to be deleted from a stored response after validation.

- `1xx` warn-codes describe the freshness or validation status of the
response and will be deleted by a cache after deletion.
- `2xx` warn-codes describe some aspect of the representation that is
not rectified by a validation and will not be deleted by a cache after validation
unless a full response is sent.
- `1xx` warn-codes describe the freshness or validation status of the response and will be deleted by a cache after deletion.
- `2xx` warn-codes describe some aspect of the representation that is not rectified by a validation and will not be deleted by a cache after validation unless a full response is sent.

- \<warn-agent>
- : The name or pseudonym of the server or software adding the `Warning`
header (might be "-" when the agent is unknown).
- : The name or pseudonym of the server or software adding the `Warning` header (might be "-" when the agent is unknown).
- \<warn-text>
- : An advisory text describing the error.
- \<warn-date>
- : A date. This is optional. If more than one `Warning` header is sent, include a date that
matches the {{HTTPHeader("Date")}} header.
- : A date. This is optional. If more than one `Warning` header is sent, include a date that matches the {{HTTPHeader("Date")}} header.

## Warning codes

Expand Down

0 comments on commit c71fd9d

Please sign in to comment.