blob: 60f1ad77d0387f6145e681f2b197e4db7b9f9386 (
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
Release Process
===============
- Update the release notes:
1. Review and cleanup ``doc/release/release_dev.rst``,
2. Fix code in documentation by running
``cd doc && make doctest``.
3. Make a list of merges and contributors by running
``doc/release/contribs.py <tag of previous release>``.
4. Paste this list at the end of the ``release_dev.rst``. Scan the PR titles
for highlights, deprecations, and API changes, and mention these in the
relevant sections of the notes.
5. Rename to ``doc/release/release_<major>.<minor>.rst``.
6. Copy ``doc/release/release_template.rst`` to
``doc/release/release_dev.rst`` for the next release.
7. Add ``release_<major>.<minor>`` to ``doc/release/index.rst``.
- Delete developer banner on docs::
git rm doc/_templates/layout.html
- Update ``__version__`` in ``networkx/__init__.py``.
- Commit changes::
git add networkx/__init__.py
git commit -m "Designate X.X release"
- Add the version number as a tag in git::
git tag -s [-u <key-id>] networkx-<major>.<minor> -m 'signed <major>.<minor> tag'
(If you do not have a gpg key, use -m instead; it is important for
Debian packaging that the tags are annotated)
- Push the new meta-data to github::
git push --tags origin main
(where ``origin`` is the name of the
``github.com:networkx/networkx`` repository.)
- Review the github release page::
https://github.com/networkx/networkx/tags
- Pin badges in ``README.rst``::
- https://github.com/networkx/networkx/workflows/test/badge.svg?tag=networkx-<major>.<minor>
- https://github.com/networkx/networkx/actions?query=branch%3Anetworkx-<major>.<minor>
- Publish on PyPi::
git clean -fxd
pip install -r requirements/release.txt
python -m build --sdist --wheel
twine upload -s dist/*
- Unpin badges in ``README.rst``::
git restore README.rst
- Update documentation on the web:
The documentation is kept in a separate repo: networkx/documentation
- Wait for the CI service to deploy to GitHub Pages
- Sync your branch with the remote repo: ``git pull``.
- Copy the documentation built by the CI service.
Assuming you are at the top-level of the ``documentation`` repo::
# FIXME - use eol_banner.html
cp -a latest networkx-<major>.<minor>
ln -sfn networkx-<major>.<minor> stable
git add networkx-<major>.<minor> stable
git commit -m "Add <major>.<minor> docs"
# maybe squash all the Deploy GitHub Pages commits
# git rebase -i HEAD~XX where XX is the number of commits back
# check you didn't break anything
# diff -r latest networkx-<major>.<minor>
# you will then need to force the push so be careful!
git push
- Update ``__version__`` in ``networkx/__init__.py``.
- Create ``doc/_templates/layout.html`` with::
{% extends "!layout.html" %}
{% block content %}
{% include "dev_banner.html" %}
{{ super() }}
{% endblock %}
- Commit and push changes::
git add networkx/__init__.py doc/_templates/layout.html
git commit -m "Bump release version"
git push origin main
- Update the web frontpage:
The webpage is kept in a separate repo: networkx/website
- Sync your branch with the remote repo: ``git pull``.
If you try to ``make github`` when your branch is out of sync, it
creates headaches.
- Update ``build/index.html``.
- Edit ``build/_static/docversions.js`` and commit
- Push your changes to the repo.
- Deploy using ``make github``.
- Post release notes on mailing list.
- networkx-discuss@googlegroups.com
|