From a575d1f9d77195d53f55fa8b409bd7c21f3f64de Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Sun, 17 Apr 2016 15:38:26 -0700 Subject: update RELEASING.txt to better account for master and previous branches - add term "final" release - explicitify the implicit - --- RELEASING.txt | 69 +++++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 58 insertions(+), 11 deletions(-) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index 866fff305..8b3d908e6 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -6,12 +6,19 @@ Releasing Pyramid - 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 release is final when it is no longer pre-release. + - 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. +Prepare new release branch +-------------------------- + +- Create a new release branch, incrementing the version number. + - Do any necessary branch merges (e.g., master to branch, branch to master). - On release branch: @@ -34,6 +41,8 @@ Releasing Pyramid - Ensure all features of the release are documented (audit CHANGES.txt or communicate with contributors). +- Change CHANGES.txt heading to reflect the new version number. + - Copy relevant changes (delta bug fixes) from CHANGES.txt to docs/whatsnew-X.X (if it's a major release). Minor releases should include a link under "Bug Fix Releases" to the minor feature @@ -52,10 +61,7 @@ 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 on both master and the new - branch. - -- Change CHANGES.txt heading to reflect the new version number. +- Change setup.py version to the release version number. - Make sure PyPI long description renders (requires ``collective.dist`` installed into your Python):: @@ -70,6 +76,37 @@ Releasing Pyramid $ python setup.py sdist bdist_wheel $ twine upload dist/pyramid-X.X-* +- Configure RTD to publish the new release version of the docs. + +Prepare master for further development (major releases only) +------------------------------------------------------------ + +- Checkout master. + +- In CHANGES.txt, preserve headings but clear out content. + +- From the release branch, forward port the changes in CHANGES.txt to + HISTORY.txt. + +- In contributing.md, forward port branch descriptions from release branch. + +- In docs/conf.py, add a commented line under + pylons_sphinx_latesturl_pagename_overrides for the release. + +- Change setup.py version to the next version number. + +Update previous version (final releases only) +--------------------------------------------- + +- In docs/conf.py, update values under html_theme_options for in_progress and + outdated. Uncomment the sections to enable pylons_sphinx_latesturl. + +- Configure RTD to point the "latest" alias to the new release version of the + docs. + +Marketing and communications +---------------------------- + - Edit Pylons/pylonshq/templates/home/home.mako. - Edit Pylons/pylonshq/templates/home/inside.rst for major releases only. @@ -82,15 +119,24 @@ Releasing Pyramid - Edit `http://wiki.python.org/moin/WebFrameworks `_. -- Publish new version of docs. +- Announce to Twitter. -- Announce to maillist. +``` +Pyramid 1.x released. -- Announce to Twitter. +PyPI +https://pypi.python.org/pypi/pyramid/1.x + +What's New +http://docs.pylonsproject.org/projects/pyramid/1.X/whatsnew-1.X.html -Announcement template ----------------------- +Issues +https://github.com/Pylons/pyramid/issues +``` + +- Announce to maillist. +``` Pyramid 1.X.X has been released. Here are the changes: @@ -106,11 +152,12 @@ at http://docs.pylonsproject.org/projects/pyramid/1.X/ . You can install it via PyPI: - easy_install Pyramid==1.X + pip install Pyramid==1.X Enjoy, and please report any issues you find to the issue tracker at https://github.com/Pylons/pyramid/issues Thanks! -- C +- Pyramid core developers +``` -- cgit v1.2.3 From b5237a573acb1dedebc236e852f4437c66fd26be Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Sun, 17 Apr 2016 15:54:06 -0700 Subject: update RELEASING.txt with "unreleased" heading --- RELEASING.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index 8b3d908e6..e50adb52b 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -83,7 +83,8 @@ Prepare master for further development (major releases only) - Checkout master. -- In CHANGES.txt, preserve headings but clear out content. +- In CHANGES.txt, preserve headings but clear out content. Add heading + "unreleased" for the version number. - From the release branch, forward port the changes in CHANGES.txt to HISTORY.txt. -- cgit v1.2.3 From 13522a677e2700c84a10709fd758f379110780f8 Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 19 Apr 2016 23:42:18 -0700 Subject: Fix what's new links in templates with "-branch" in RELEASING.txt --- RELEASING.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index e50adb52b..78fd98f52 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -129,7 +129,7 @@ PyPI https://pypi.python.org/pypi/pyramid/1.x What's New -http://docs.pylonsproject.org/projects/pyramid/1.X/whatsnew-1.X.html +http://docs.pylonsproject.org/projects/pyramid/1.X-branch/whatsnew-1.X.html Issues https://github.com/Pylons/pyramid/issues @@ -145,11 +145,11 @@ Here are the changes: <> A "What's New In Pyramid 1.X" document exists at -http://docs.pylonsproject.org/projects/pyramid/1.X/whatsnew-1.X.html . +http://docs.pylonsproject.org/projects/pyramid/1.X-branch/whatsnew-1.X.html . You will be able to see the 1.X release documentation (across all alphas and betas, as well as when it eventually gets to final release) -at http://docs.pylonsproject.org/projects/pyramid/1.X/ . +at http://docs.pylonsproject.org/projects/pyramid/1.X-branch/ . You can install it via PyPI: -- cgit v1.2.3 From 478c6ef8c05bea4541844e40c9428d573266e9dc Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Mon, 2 May 2016 04:35:45 -0700 Subject: fix what's new link (cherry picked from commit 023b6ba) --- RELEASING.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index 78fd98f52..a09b6d24a 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -129,7 +129,7 @@ PyPI https://pypi.python.org/pypi/pyramid/1.x What's New -http://docs.pylonsproject.org/projects/pyramid/1.X-branch/whatsnew-1.X.html +http://docs.pylonsproject.org/projects/pyramid/en/1.X-branch/whatsnew-1.X.html Issues https://github.com/Pylons/pyramid/issues -- cgit v1.2.3 From 1d7501afdda49cf5e7561e542988581c360f4ed2 Mon Sep 17 00:00:00 2001 From: Michael Merickel Date: Tue, 10 May 2016 00:42:08 -0500 Subject: drop pypy3 from scaffold tests --- RELEASING.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index a09b6d24a..4b4f40f99 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -33,8 +33,8 @@ Prepare new release branch - Run tests on Windows if feasible. -- Make sure all scaffold tests pass (Py 2.7, 3.3, 3.4, 3.5, pypy, and pypy3 on - UNIX; this doesn't work on Windows): +- Make sure all scaffold tests pass (Py 2.7, 3.3, 3.4, 3.5, and pypy on UNIX; + this doesn't work on Windows): $ ./scaffoldtests.sh -- cgit v1.2.3 From 9b4eedc84c335b690f04fc155ccd38a615b9594b Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 10 May 2016 00:04:32 -0700 Subject: update twitter announcement --- RELEASING.txt | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'RELEASING.txt') diff --git a/RELEASING.txt b/RELEASING.txt index 4b4f40f99..d8572fa94 100644 --- a/RELEASING.txt +++ b/RELEASING.txt @@ -128,8 +128,12 @@ Pyramid 1.x released. PyPI https://pypi.python.org/pypi/pyramid/1.x +=== One time only for new version, first pre-release === What's New http://docs.pylonsproject.org/projects/pyramid/en/1.X-branch/whatsnew-1.X.html +=== For all subsequent pre-releases === +Changes +http://docs.pylonsproject.org/projects/pyramid/en/1.X-branch/changes.html#version-yyyy-mm-dd Issues https://github.com/Pylons/pyramid/issues -- cgit v1.2.3