update docs pypi instructions (#4077)

SciTools · Mar 29, 2021 · 3fec756 · 3fec756
1 parent f76288c
commit 3fec756
Showing 1 changed file with 12 additions and 3 deletions.
diff --git a/docs/src/developers_guide/release.rst b/docs/src/developers_guide/release.rst
@@ -119,10 +119,19 @@ Build the source distribution and wheel from the Iris root directory::
 This ``./dist`` directory should now be populated with the source archive
 ``.tar.gz`` file, and built distribution ``.whl`` file.
 
-Sufficient maintainer privileges will be required to upload these artifacts
-to `scitools-iris`_ on PyPI::
+Check that the package description will render properly on PyPI for each
+of the built artifacts::
 
-    > python -m twine upload --repository-url https://upload.pypi.org/legecy/ ./dist/*
+    > python -m twine check dist/*
+
+To list and check the contents of the binary wheel::
+
+    > python -m zipfile --list dist/*.whl
+
+If all seems well, sufficient maintainer privileges will be required to
+upload these artifacts to `scitools-iris`_ on PyPI::
+
+    > python -m twine upload --repository-url https://upload.pypi.org/legecy/ dist/*
 
 Ensure that the artifacts are successfully uploaded and available on
 `scitools-iris`_ before creating a conda test environment to install Iris