diff --git a/PACKAGE.md b/PACKAGE.md
new file mode 100644
index 0000000..230c8f3
--- /dev/null
+++ b/PACKAGE.md
@@ -0,0 +1,28 @@
+
+## Instructions for how to update the version of the sootty package of PyPI:
+
+1) Update the version number in `setup.py`.
+2) Run this command to package the new version into the `dist` directory:
+
+<!--  -->
+
+    python3 setup.py sdist bdist_wheel
+
+
+3) Run to check that the package contains the correct files:
+
+<!--  -->
+
+    tar tzf dist/sootty-<version>.tar.gz
+
+4) Run to check whether the package will correctly render to PyPI:
+
+<!--  -->
+
+    twine check dist/*
+
+5) Upload the newly created files to PyPI:
+
+<!-- well hey there sailor! don't delete these comments because they actually affect the markdown rendering :-) -->
+
+    twine upload dist/sootty-<version>.tar.gz  dist/sootty-<version>-py3-none-any.whl
diff --git a/setup.py b/setup.py
index c05fd03..a56b3ee 100644
--- a/setup.py
+++ b/setup.py
@@ -10,7 +10,7 @@
 
 setuptools.setup( 
     name='sootty',
-    version='0.2.2',
+    version='0.2.3',
     description='Displays vcd files to the command line.', 
     long_description=README,
     packages=setuptools.find_packages(exclude=("tests",)),