diff --git a/readme.md b/readme.md
index cd2d2fe8..22289fef 100644
--- a/readme.md
+++ b/readme.md
@@ -1 +1,16 @@
 # nixfiles
+
+## Build and Deploy
+
+```shell
+:; nf-deploy build
+# switch without committing to it...
+:; nf-deploy test
+:; nf-deploy switch
+```
+
+## Editing Secrets
+
+```shell
+sops nixos/systems/tewi/secrets.yaml
+```