summaryrefslogtreecommitdiff
path: root/admin/README.md
blob: e56c2612ac7509f7da52c82ad93a156a2df29e8b (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
# Admin Tools

Tools to assist with RDFlib releases, like extracting all merged PRs from GitHub since last release.


## Release procedure

1. merge all PRs for the release
1. pass all tests
1. black everything 
   * use the config, e.g. `black --config black.toml .` in main dir
1. build docs - check for errors/warnings there
1. alter version & date in rdflib/__init__.py
1. update:
    * CHANGELOG.md
    * CONTRIBUTORS
       * use scripts here to generate "PRs since last release"
    * LICENSE (the date)
    * setup.py (the long description)
1. update admin steps (here)
1. push to PyPI
    * `pip3 install twine wheel`
    * `python3 setup.py bdist_wheel sdist`
    * `twine upload ./dist/*`
1. Make GitHub release
    * go to the tagged version, e.g. https://github.com/RDFLib/rdflib/releases/tag/6.0.0
    * edit the release' notes there (likely copy from CHANGELOG)
1. Build readthedocs docco
    * `latest` and `stable` need to be built at least
    * best to make sure the previous (outgoing) release has a number-pegged version, e.g. 5.0.0
1. update the rdflib.dev website page