ars / docs / maintainers / Procedure to create and upload a release .txt

Full commit

XYZ: the 'version' string kwarg in the call to setup() in
%date: date in format YYYY.MM.DD

0) clean working directory. The best choice is to shelve all changes.

1) test that the source distribution is created appropriately (in all the archive formats)
	$ python sdist --formats=gztar,zip

2) update version/release number and commit. Change it in

3) in branch 'default', merge with 'dev' and tag previous changeset
(e.g. 1084 = 9fa5876718f0) with the output of `ars.get_version()` e.g. '0.5a2'
	$ hg up default
	$ hg merge dev-main
	$ hg tag --rev 1084 "--message=Added tag 0.5a2 for changeset 9fa5876718f0" 0.5a2

4) create and upload source distribution to PyPI
Alternative A
	$ python sdist --formats=gztar,zip upload

Alternative B
	Go to
	and "PKG-INFO file" > "Choose file" > "Add Package Info" to create a new
	release manually. Then upload both files (gzip and zip) with "File type"
	set to "source".

5) test installation with 'pip'
	$ sudo pip install ARS
	$ python
	>>> import ars

6) $ hg push

7) go to and create a folder named 'XYZ %date'

8) upload these files to that folder

9) set the .zip as the default download for Windows and Mac OSX, and the .gz
	for all the rest.

NOT anymore (download URLs are dynamically created for tags e.g.
10) upload the same files here:

11) Verify documentation builds passed here: