mirror of
https://github.com/semver/semver.git
synced 2026-07-11 05:12:48 -05:00
[GH-ISSUE #367] Deprecation and how to do it #2989
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @dret on GitHub (Apr 28, 2017).
Original GitHub issue: https://github.com/semver/semver/issues/367
reading that deprecation should be announced via a minor version before being rolled out: would https://tools.ietf.org/html/draft-wilde-sunset-header help as a way to do it? after all, the deprecation notice ideally should be machine-understandable and ideally, this shouldn't have to be re-invented by every single API individually.
@dret commented on GitHub (Apr 28, 2017):
i just added
d5b738d49e(deprecation) as one scenario to the draft. i am planning on publishing a new version soon.@jwdonahue commented on GitHub (Nov 28, 2017):
It seems likely that for service interfaces over HTTP, https://tools.ietf.org/html/draft-wilde-sunset-header would be a wise choice, in conjunction with the specified SemVer behavior.
The Sunset HTTP Header is beyond the scope of the SemVer specification. Please close this issue at your earliest convenience.
@dret commented on GitHub (Nov 28, 2017):
not a problem. thanks for looking into it.