add current release procedure howto

Author: nikohansen

howto/release.md

@@ -0,0 +1,58 @@
+Testing:
+
+```sh
+    python -m moarchiving.test
+    ruff check --ignore F401 --ignore E722 --ignore E741 moarchiving
+```
+
+Final final changes to version numbers etc.:
+
+```sh
+    __init__.py  # edit version number
+    # not applicable: tools/conda.recipe/meta.yaml  # edit version number
+    moarchiving.ipynb  # add release description
+    README.md + .html  # created from moarchiving.ipynb, see howto/update_readme.md
+    merge development branch to master if necessary
+```
+
+To prepare a distribution from a dirty code folder:
+
+```sh
+    # CAVEAT: backup is also a homebrew minitool (not meant here)
+    backup install-folder --move
+    backup moarchiving --move 
+    mkdir install-folder
+    git checkout -- moarchiving
+    cp -r moarchiving pyproject.toml LICENSE install-folder
+    backup --recover  # recover last above moved folder (and backup current, just in case)
+```
+
+Make distribution
+
+```sh
+    cd install-folder
+    python -c "open('README.md', 'w').write(open('../README.md', 'r').read().split('### 11')[0])"
+    python -m build > dist_call_output.txt
+    less dist_call_output.txt  # not very informative
+    ll dist  # just checking creation date
+    tar -tf dist/moarchiving-1.0.0.tar.gz | tree --fromfile  # check that the distribution folders are clean
+```
+
+Check distribution and project description:
+
+```sh
+    twine check dist/*  # install/update/upgrade pkginfo if this fails
+    cp dist/* ../dist
+```
+
+Copy changes in install-folder to root folder and commit (not clear how exactly, Diff Folders may help).
+
+Finally, upload the distribution:
+
+```sh
+    twine upload dist/*1.0.x*  # to not upload outdated stuff
+```
+
+With `setuptools_scm`:
+
+      -> expected: ERROR setuptools_scm._file_finders.git listing git files failed - pretending there aren't any