diff --git a/marzipan/README.md b/marzipan/README.md
new file mode 100644
index 0000000..3ea7136
--- /dev/null
+++ b/marzipan/README.md
@@ -0,0 +1,9 @@
+# Rewriting analyze.sh in Python
+
+* `../analyze.sh` is the old script
+* `src/analyze.sh` is the new script
+
+* call the old script from the Rosenpass repository's root directory with `./analyze.sh`
+* call the new script:
+  * `nix shell`
+  * `src/analyze.sh analyze $repo` where `$repo` is the absolute(?) path to the root directory of the Rosenpass repository.