Skip to content
This repository was archived by the owner on Jul 7, 2025. It is now read-only.

Commit f6cc119

Browse files
committed
Addresses Artart review @reschke @fpalombini #34
1 parent ac79dde commit f6cc119

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

draft-ietf-httpapi-deprecation-header.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ Deprecation of an HTTP resource ({{Section 3.1 of HTTP}}) communicates informati
5656

5757
The act of deprecation does not change any behavior of the resource. It informs clients of the fact that a resource will be or is deprecated. The Deprecation HTTP response header field can be used to convey this at runtime to clients and carries information indicating when the deprecation will be in effect.
5858

59-
In addition to the Deprecation header field, the resource provider can use other header fields to convey additional information related to deprecation. This can be information such as where to find documentation related to the deprecation, what can be used as a replacement, and when a deprecated resource becomes non-operational.
59+
In addition to the Deprecation header field, the resource provider can use other header fields such as Link ([LINK]) to convey additional information related to deprecation. This can be information such as where to find documentation related to the deprecation, what can be used as a replacement, and when a deprecated resource becomes non-operational.
6060

6161

6262
## Notational Conventions
@@ -75,13 +75,13 @@ The `Deprecation` HTTP response header field allows a server to communicate to a
7575

7676
The `Deprecation` response header field describes the deprecation of the resource identified with the response it occurred within (see {{Section 6.4.2 of HTTP}}). It conveys the deprecation date, which may be in the future (the resource context will be deprecated at that date) or in the past (the resource context has been deprecated at that date). `Deprecation` is an Item Structured Header {{!RFC8941}}. Refer to Section 3.3.7 of [STRUCTURED-FIELDS] for `sf-date`:
7777

78-
Deprecation = sf-date
78+
"Deprecation = sf-date"
7979

8080

8181

8282
The date is the date when the resource was or will be deprecated. It is in the form of an Structured Field Date as defined in Section 3.3.7 of [STRUCTURED-FIELDS].
8383

84-
The following example shows that the resource context has been deprecated on Friday, June 30, 2023 at 23:59:59 GMT:
84+
The following example shows that the resource context has been deprecated on Friday, June 30, 2023 at 23:59:59 UTC:
8585

8686
Deprecation: @1688169599
8787

@@ -130,10 +130,10 @@ In addition to the deprecation related information, if the resource provider wan
130130

131131
The timestamp given in the `Sunset` header field MUST NOT be earlier than the one given in the `Deprecation` header field.
132132

133-
The following example shows that the resource in context has been deprecated since Friday, June 30, 2023 at 23:59:59 GMT and its sunset date is Sunday, June 30, 2024 at 23:59:59 GMT. Please note that for historical reasons the Sunset HTTP header field uses a different data type for date.
133+
The following example shows that the resource in context has been deprecated since Friday, June 30, 2023 at 23:59:59 UTC and its sunset date is Sunday, June 30, 2024 at 23:59:59 UTC. Please note that for historical reasons the Sunset HTTP header field uses a different data format for date.
134134

135135
Deprecation: @1688169599
136-
Sunset: Sun, 30 Jun 2024 23:59:59 GMT
136+
Sunset: Sun, 30 Jun 2024 23:59:59 UTC
137137

138138
# Resource Behavior
139139

@@ -182,7 +182,7 @@ Resource documentation SHOULD provide additional information about the deprecati
182182

183183
Note to RFC Editor: Please remove this section before publication.
184184

185-
This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft, and is based on a proposal described in {{?RFC7942}}. The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that
185+
This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft. The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that
186186
other implementations may exist.
187187

188188
According to RFC 7942, "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature. It is up to the individual working groups to use this information as they see fit".
@@ -244,7 +244,7 @@ Organization: IBM
244244

245245
Organization: Ultipro
246246

247-
- Description: Ultipro uses the HTTP `Warning` header field as described in Section 5.5 of {{!RFC9111}} with code `299`
247+
- Description: Ultipro uses the HTTP `Warning` header field as described in Section 5.5 of RFC 9111 with code `299`
248248
- Reference: https://connect.ultipro.com/api-deprecation
249249

250250
Organization: Clearbit

0 commit comments

Comments
 (0)