-
Notifications
You must be signed in to change notification settings - Fork 73
/
release_process.txt
88 lines (59 loc) · 2.55 KB
/
release_process.txt
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
83
84
85
86
87
88
.. _RefReleaseProcess:
Release process
****************************************************************************
Preparation
============================================================================
#. Version number and release branch
#. Determine the appropriate version number for this release,
according to :ref:`RefReleaseVersioning`.
#. Update the :file:`version.txt` file to contain the new version
number.
#. Tickets
#. Update ticket status for this release, where relevant:
https://github.com/dictation-toolbox/dragonfly/issues
#. Release files
#. Verify that :file:`CHANGELOG.rst` includes the change log for this
release.
#. Verify that :file:`AUTHORS.txt` is up to date with recent
contributors.
#. Verify that :file:`setup.py` specifies all required
dependencies, including their versions, e.g. with the
``install_requires`` and ``test_requires`` parameters.
#. Verify that :file:`documentation/requirements.txt` specifies all
required dependencies for building the documentation.
#. Verify that :file:`MANIFEST.in` includes all necessary
data files.
#. Draft announcement
#. Write a draft announcement text to send to the mailing list after
the release process has been completed.
Build and test
============================================================================
#. Test building of documentation
#. Build distributions
#. Test installation of distributions
#. Test on PyPI test server (`test.pypi.org <http://test.pypi.org/>`__)
#. Upload distributions to PyPI test server
#. Test installation from PyPI test server
#. Verify package is displayed correctly on PyPI test server
#. Tag release
#. Tag git revision as ``X.Y.Z``
#. Push to GitHub
Release
============================================================================
#. Upload to GitHub
#. Upload distributions to GitHub:
https://github.com/dictation-toolbox/dragonfly/releases
#. Trigger building of documentation on Read the Docs
#. Check whether documentation was built automatically, and if not
trigger it:
https://readthedocs.org/builds/dragonfly2/
#. Upload to PyPI server
#. Upload distributions to PyPI server
#. Test installation from PyPI server
#. Verify package is displayed correctly on PyPI server
Post-release
============================================================================
#. Announce release
#. Website
#. Mailing list
#. Gitter channel