diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f8c84db
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+very simple CI/CD setup for my [tilde.club](https://tilde.club/~simponic)
+
+instructions:
+
+1. generate a new ssh key with no password (i.e. @ /tmp/id_ed25519)
+2. add the key to .ssh/authorized_keys @ tilde.club 
+3. set SSH_CONNECTION_STRING in drone.io worker secrets to "<username>@tilde.club"
+4. set SSH_KEY to (echo /tmp/id_ed25519 | base64 -e --wrap=0)
+5. profit