mirror of
https://github.com/semver/semver.git
synced 2025-08-27 08:15:30 +00:00
commit
3c7f2e8df7
15
semver.md
15
semver.md
@ -200,15 +200,24 @@ are important to your users, use the version number to inform them.
|
|||||||
|
|
||||||
### How should I handle deprecating functionality?
|
### How should I handle deprecating functionality?
|
||||||
|
|
||||||
Deprecating existing functionality is a normal part of software development and is often required to make forward progress. When you deprecate part of your public API, you should do two things: (1) update your documentation to let users know about the change, (2) issue a new minor release with the deprecation in place. Before you completely remove the functionality in a new major release there should be at least one minor release that contains the deprecation so that users can smoothly transition to the new API.
|
Deprecating existing functionality is a normal part of software development and
|
||||||
|
is often required to make forward progress. When you deprecate part of your
|
||||||
|
public API, you should do two things: (1) update your documentation to let
|
||||||
|
users know about the change, (2) issue a new minor release with the deprecation
|
||||||
|
in place. Before you completely remove the functionality in a new major release
|
||||||
|
there should be at least one minor release that contains the deprecation so
|
||||||
|
that users can smoothly transition to the new API.
|
||||||
|
|
||||||
|
|
||||||
About
|
About
|
||||||
-----
|
-----
|
||||||
|
|
||||||
The Semantic Versioning specification is authored by [Tom Preston-Werner](http://tom.preston-werner.com), inventor of Gravatars and cofounder of GitHub.
|
The Semantic Versioning specification is authored by [Tom
|
||||||
|
Preston-Werner](http://tom.preston-werner.com), inventor of Gravatars and
|
||||||
|
cofounder of GitHub.
|
||||||
|
|
||||||
If you'd like to leave feedback, please [open an issue on GitHub](https://github.com/mojombo/semver/issues).
|
If you'd like to leave feedback, please [open an issue on
|
||||||
|
GitHub](https://github.com/mojombo/semver/issues).
|
||||||
|
|
||||||
|
|
||||||
License
|
License
|
||||||
|
Loading…
Reference in New Issue
Block a user