From 317f556ace18bd017013ff1f7d595079be69c937 Mon Sep 17 00:00:00 2001 From: Jo Liss Date: Tue, 10 Jan 2012 14:26:32 +0100 Subject: [PATCH] Wrap. --- semver.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/semver.md b/semver.md index 76440f9..6ead687 100644 --- a/semver.md +++ b/semver.md @@ -200,15 +200,24 @@ are important to your users, use the version number to inform them. ### 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 ----- -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