aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJason R. Coombs <jaraco@jaraco.com>2014-12-25 12:53:06 -0500
committerJason R. Coombs <jaraco@jaraco.com>2014-12-25 12:53:06 -0500
commit7648e18df3bb35335f455d6026252393a3e84a2d (patch)
tree84ed04b046535767a48bfdd27a21364ba4da9038
parent76097f794beeb7a2bf7f18b27a6a3d13e5da1eaa (diff)
downloadexternal_python_setuptools-7648e18df3bb35335f455d6026252393a3e84a2d.tar.gz
external_python_setuptools-7648e18df3bb35335f455d6026252393a3e84a2d.tar.bz2
external_python_setuptools-7648e18df3bb35335f455d6026252393a3e84a2d.zip
Update documentation on release frequency.
-rw-r--r--docs/releases.txt19
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/releases.txt b/docs/releases.txt
index 66c0896f..4c8d6b8d 100644
--- a/docs/releases.txt
+++ b/docs/releases.txt
@@ -17,6 +17,25 @@ revision slated for release::
python -m jaraco.packaging.release
+Release Frequency
+-----------------
+
+Some have asked why Setuptools is released so frequently. Because Setuptools
+uses a mechanical release process, it's very easy to make releases whenever the
+code is stable (tests are passing). As a result, the philosophy is to release
+early and often.
+
+While some find the frequent releases somewhat surprising, they only empower
+the user. Although releases are made frequently, users can choose the frequency
+at which they use those releases. If instead Setuptools contributions were only
+released in batches, the user would be constrained to only use Setuptools when
+those official releases were made. With frequent releases, the user can govern
+exactly how often he wishes to update.
+
+Frequent releases also then obviate the need for dev or beta releases in most
+cases. Because releases are made early and often, bugs are discovered and
+corrected quickly, in many cases before other users have yet to encounter them.
+
Release Managers
----------------