M README → README

@@ -92,9 +92,10 @@ 3: the layout
 
          --- 1: the utility ---
 
-  simply run the "zoa" tool on all of your systems. it's a simple binary (XXX: or
-  shell script?) that can be installed trivially. it expects to run as root, and
-  it should run on a cron/timer/whatever schedule at whatever interval you want.
+  simply run zoa on all of your systems. it's a simple binary that can be installed
+  trivially.
+  it expects to run as root, and it should probably run on a cron/timer/whatever
+  schedule at whatever interval you want.
 
   install:
     wget -O  https://j3s.sh/zoa/zoa # TODO
@@ -107,28 +108,17 @@ 
   to run zoa:
     zoa https://git.j3s.sh/j3s/config main
     ^              ^                   ^
-  zoa, duh.       git repo             git ref (branch or tag)
-
-  zoa will clone the repo+ref specified (or attempt to
-  fetch it, if it's already cloned) to /var/lib/zoa/repo
-
-  zoa will then execute /var/lib/zoa/repo/main
-
-
-  zoa will see that it's a different repo & will set everything up for you.
-
-  if you run "zoa" with 0 arguments, zoa will cd to /var/lib/zoa/repo, git fetch,
-  and execute the main script.
-
-  dev mode: if you run "zoa .", zoa will execute whatever is in the $PWD - this
-  is mainly for my own sanity.
+  zoa, duh.       git repo             optional git branch
 
-  if you ever want to change the repo you're pointed at, simply run the long form
-  of zoa again:
+  zoa will clone the repo+branch specified to /var/lib/zoa/repo, and then
+  it will execute
 
-  zoa https://git.j3s.sh/j3s/a-different-zoa-repo dev
+  you can also run zoa in local-mode by specifying a dir:
+    zoa /path/to/zoa/dir
+  
+  in which case, zoa will just execute whatever is in the dir you specify
 
-  that's it, you've configured your server! now set up a cronjob/systemd timer to
+  that's it, you've run zoa! now set up a cronjob/systemd timer to
   run zoa on a schedule, if that's your thing. or just login and run zoa
   periodically.
 
@@ -141,9 +131,9 @@ 
          --- 2: environment variables and helper functions ---
 
   in zoa, you write plain POSIX shell. Why?
-  - posix shell is productive
-  - posix shell is portable
-  - posix shell is hard to make too complicated
+  - posix shell is productive (fun)!
+  - posix shell is portable (everywhere)!
+  - posix shell is hard to make too complicated (fights complexity bc it's spaghetti)!
 
                         ENVIRONMENT VARIABLES