M README → README

@@ -2,13 +2,13 @@ ?????????????????
                 ?  what is zoa  ?
                 ?????????????????
 
-  zoa is a simple config management tool. it's the
-  best. it's written in shell, has a few nice
-  cute little helper functions, and doesn't go out
-  of its way to make you hate yourself.
+  zoa is a simple, opinionated, shell-based config management tool.
+        it's the best. it's pull-based.
 
-  zoa requires access to a git repo, though it may be used
-  in local development mode.
+  zoa makes you feel good about config management.
+
+  zoa config lives in a git repo, and all of the systems you manage
+  simply point at the repo.
 
   zoa is intended for human-scale deployment, and generally
   works best if you're not trying to manage a crazy complicated
@@ -18,6 +18,18 @@ minimal effort.
 
   it's also for individuals who like understanding their systems,
   and hate maintaining them when things break for no reason.
+
+  you might like zoa if:
+  - you enjoy alpine, gentoo, linux from scratch, etc
+  - you use a tiling window manager
+  - you like messing with dotfiles
+  - you dislike chef, ansible, saltstack, and puppet intensely
+  - you like smallness and simplicity
+
+  you might not like zoa if:
+  - you are an abstraction enjoyer
+  - you dislike shell, the language
+  - you dislike the terminal in general
 
 
 
@@ -121,9 +133,9 @@ of zoa not being "fully" standards compliant.
 
 
 
-               !!!!!!!!!!!!!!!!!!
-               !   QUICKSTART   !
-               !!!!!!!!!!!!!!!!!!
+               !!!!!!!!!!!!!!!!!
+               !    DETAILS    !
+               !!!!!!!!!!!!!!!!!
 
   - ~ - understand: there are three components - ~ -