diff options
author | Takeshi KOMIYA <i.tkomiya@gmail.com> | 2018-02-06 17:19:25 +0300 |
---|---|---|
committer | Takeshi KOMIYA <i.tkomiya@gmail.com> | 2018-02-06 17:19:32 +0300 |
commit | 94eae2c4f93fd5b46760eae4a78844e07e3b96f6 (patch) | |
tree | 7b1113b358855b7723fd4dcfbd8859674fc89486 /utils/release-checklist | |
parent | 7e5974f26c44c09c82373d42e1a15d1ee8981a3e (diff) |
Add procedures for beta and final releases
Diffstat (limited to 'utils/release-checklist')
-rw-r--r-- | utils/release-checklist | 103 |
1 files changed, 89 insertions, 14 deletions
diff --git a/utils/release-checklist b/utils/release-checklist index fa537014f..4ef8092e6 100644 --- a/utils/release-checklist +++ b/utils/release-checklist @@ -1,37 +1,112 @@ Release checklist ================= +for stable releases +------------------- + * open https://travis-ci.org/sphinx-doc/sphinx/branches and check **X.Y** branch is green * Run `git status` and check nothing changed -* Update sphinx/locale/sphinx.pot if first major release (beta1) +* `python utils/bump_version.py X.Y.Z` +* Check diff by `git diff` +* Edit CHANGES if empty section exists +* `git commit -am 'Bump to X.Y.Z final'` +* `make clean` +* `python setup.py release bdist_wheel sdist upload --identity=[your key]` +* open https://pypi.python.org/pypi/Sphinx and check there are no obvious errors +* `git tag vX.Y.Z` +* `python utils/bump_version.py --in-develop X.Y.Zb0` (ex. 1.5.3b0) +* Check diff by `git diff` +* `git commit -am 'Bump version'` +* `git push origin X.Y --tags` +* `git checkout master` +* `git merge X.Y` +* `git push origin master` +* Update `sphinx-doc-translations <https://github.com/sphinx-doc/sphinx-doc-translations>`_ +* Add new version/milestone to tracker categories +* Write announcement and send to sphinx-dev, sphinx-users and python-announce - * Run `python setup.py extract_messages` - * Run `(cd sphinx/locale; tx push -s)` +for first beta releases +----------------------- -* Update sphinx/locale/<lang>/ files if final major release ... +* open https://travis-ci.org/sphinx-doc/sphinx/branches and check **master** branch is green +* Run `git status` and check nothing changed +* Run `python setup.py extract_messages` +* Run `(cd sphinx/locale; tx push -s)` +* `python utils/bump_version.py X.Y.0b1` +* Check diff by `git diff` +* Edit CHANGES if empty section exists +* `git commit -am 'Bump to X.Y.0 beta1'` +* `make clean` +* `python setup.py release bdist_wheel sdist upload --identity=[your key]` +* open https://pypi.python.org/pypi/Sphinx and check there are no obvious errors +* `git tag vX.Y.0b1` +* `python utils/bump_version.py --in-develop X.Y.0b2` (ex. 1.6.0b2) +* Check diff by `git diff` +* `git commit -am 'Bump version'` +* `git checkout -b X.Y` +* `git push origin X.Y --tags` +* `git checkout master` +* `git merge X.Y` +* `python utils/bump_version.py --in-develop A.B.0b0` (ex. 1.7.0b0) +* Check diff by `git diff` +* `git commit -am 'Bump version'` +* `git push origin master` +* Update `sphinx-doc-translations <https://github.com/sphinx-doc/sphinx-doc-translations>`_ +* Add new version/milestone to tracker categories +* Write announcement and send to sphinx-dev, sphinx-users and python-announce - * Run `(cd sphinx/locale; tx pull -a -f)` - * Run `python setup.py compile_catalog` - * Run `git commit -am 'Update message catalogs'` +for other beta releases +----------------------- -* `python utils/bump_version.py X.Y.Z` +* open https://travis-ci.org/sphinx-doc/sphinx/branches and check **X.Y** branch is green +* Run `git status` and check nothing changed +* `python utils/bump_version.py X.Y.0bN` * Check diff by `git diff` * Edit CHANGES if empty section exists -* `git commit -am 'Bump to X.Y.Z final'` +* `git commit -am 'Bump to X.Y.0 betaN'` * `make clean` * `python setup.py release bdist_wheel sdist upload --identity=[your key]` * open https://pypi.python.org/pypi/Sphinx and check there are no obvious errors -* `git tag vX.Y.Z` -* Merge default into X.Y branch if final major release +* `git tag vX.Y.0bN` +* `python utils/bump_version.py --in-develop X.Y.0bM` (ex. 1.6.0b3) +* Check diff by `git diff` +* `git commit -am 'Bump version'` * `git push origin X.Y --tags` -* open https://readthedocs.org/dashboard/sphinx/versions/ and enable the released version -* `python utils/bump_version.py --in-develop X.Y.Zb0` (ex. 1.5.3b0) +* `git checkout master` +* `git merge X.Y` +* `git push origin master` +* Update `sphinx-doc-translations <https://github.com/sphinx-doc/sphinx-doc-translations>`_ +* Add new version/milestone to tracker categories +* Write announcement and send to sphinx-dev, sphinx-users and python-announce + +for major releases +------------------ + +* open https://travis-ci.org/sphinx-doc/sphinx/branches and check **X.Y** branch is green +* Run `git status` and check nothing changed +* Run `(cd sphinx/locale; tx pull -a -f)` +* Run `python setup.py compile_catalog` +* Run `git add sphinx` +* Run `git commit -am 'Update message catalogs'` +* `python utils/bump_version.py X.Y.0` +* Check diff by `git diff` +* Edit CHANGES if empty section exists +* `git commit -am 'Bump to X.Y.0 final'` +* `make clean` +* `python setup.py release bdist_wheel sdist upload --identity=[your key]` +* open https://pypi.python.org/pypi/Sphinx and check there are no obvious errors +* `git tag vX.Y.0` +* `python utils/bump_version.py --in-develop X.Y.1b0` (ex. 1.6.1b0) * Check diff by `git diff` * `git commit -am 'Bump version'` -* `git push origin X.Y` +* `git push origin X.Y --tags` * `git checkout master` * `git merge X.Y` * `git push origin master` +* `git checkout A.B` (checkout old stable) +* Run `git tag A.B` to paste a tag instead branch +* Run `git push origin :A.B --tags` to remove old stable branch +* open https://readthedocs.org/dashboard/sphinx/versions/ and enable the released version * Update `sphinx-doc-translations <https://github.com/sphinx-doc/sphinx-doc-translations>`_ * Add new version/milestone to tracker categories * Write announcement and send to sphinx-dev, sphinx-users and python-announce |