summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--RELEASING.txt16
-rw-r--r--docs/conf.py6
2 files changed, 18 insertions, 4 deletions
diff --git a/RELEASING.txt b/RELEASING.txt
index 614d3257b..866fff305 100644
--- a/RELEASING.txt
+++ b/RELEASING.txt
@@ -1,7 +1,18 @@
Releasing Pyramid
=================
-- Do any necessary branch merges (e.g. master to branch, branch to master).
+- For clarity, we define releases as follows.
+
+ - Alpha, beta, dev and similar statuses do not qualify whether a release is
+ major or minor. The term "pre-release" means alpha, beta, or dev.
+
+ - A *major* release is where the first number either before or after the
+ first dot increases. Examples: 1.6 to 1.7a1, or 1.8 to 2.0.
+
+ - A *minor* or *bug fix* release is where the number after the second dot
+ increases. Example: 1.6 to 1.6.1.
+
+- Do any necessary branch merges (e.g., master to branch, branch to master).
- On release branch:
@@ -41,7 +52,8 @@ Releasing Pyramid
branch, and previously released branch. Also in the previously released
branch only, uncomment the sections to enable pylons_sphinx_latesturl.
-- Change setup.py version to the new version number.
+- Change setup.py version to the new version number on both master and the new
+ branch.
- Change CHANGES.txt heading to reflect the new version number.
diff --git a/docs/conf.py b/docs/conf.py
index c40f1c875..786ff3abf 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -137,6 +137,7 @@ if book:
# 'whatsnew-1.3': 'index',
# 'whatsnew-1.4': 'index',
# 'whatsnew-1.5': 'index',
+# 'whatsnew-1.6': 'index',
# 'tutorials/gae/index': 'index',
# 'api/chameleon_text': 'api',
# 'api/chameleon_zpt': 'api',
@@ -146,9 +147,10 @@ html_theme = 'pyramid'
html_theme_path = pylons_sphinx_themes.get_html_themes_path()
html_theme_options = dict(
github_url='https://github.com/Pylons/pyramid',
- # on master branch true, else false
+ # On master branch and new branch still in
+ # pre-release status: true; else: false.
in_progress='true',
- # on previous branches/major releases true, else false
+ # On branches previous to "latest": true; else: false.
outdated='false',
)