summaryrefslogtreecommitdiff
path: root/RELEASING.txt
blob: 3116d264379409fdaec25226583cce2ed76f778d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
Releasing Pyramid
=================

- git pull

- Do platform test via tox:

  $ tox

- Make sure statement coverage is at 100%::

  $ python setup.py nosetests --with-coverage

- Make sure all scaffold tests pass:

  $ python pyramid/scaffolds/tests.py

- Ensure all features of the release are documented (audit CHANGES.txt or
  communicate with contributors).

- Copy relevant changes (delta bug fixes) from CHANGES.txt to
  docs/whatsnew-X.X (if it's a major release).

- Make sure docs render OK::

  $ cd docs
  $ make clean html

  There should be no meaningful errors or warnings.

- Change setup.py version to the new version number.

- Change docs/conf.py version to the new version number.

- Change CHANGES.txt heading to reflect the new version number.

- Make sure PyPI long description renders (requires ``collective.dist``
  installed into your Python)::

  $ python setup.py check --restructuredtext

- Create a release tag.

- Release to PyPI::

  $ python setup.py sdist register upload

- Edit `http://wiki.python.org/moin/WebFrameworks
  <http://wiki.python.org/moin/WebFrameworks>`_.

- Publish new version of docs.

- Announce to maillist.

- Announce to Twitter.

Announcement template
----------------------

Pyramid 1.1.X has been released.

Here are the changes:

<<changes>>

A "What's New In Pyramid 1.1" document exists at
http://docs.pylonsproject.org/projects/pyramid/1.1/whatsnew-1.1.html .

You will be able to see the 1.1 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.1/ .

You can install it via PyPI:

  easy_install Pyramid==1.1a4

Enjoy, and please report any issues you find to the issue tracker at
https://github.com/Pylons/pyramid/issues

Thanks!

- C