# HG changeset patch
# User Meredith Howard <mhoward@roomag.org>
# Date 1497495027 14400
# Node ID f1f2724d73a8609f6d969848126e4e316d5b7c5f
# Parent  d03c346f71c250bc20c9b3038972a36865be3d59
expand readme

diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -1,3 +1,26 @@
-# devbox-ansible
+# Devbox playbook
+
+This is a playbook that installs dev tools and DE tools I like to have around 
+and sets up some other preferences like repositories, and drops in my dotfiles.  
+It's best-tested on Debian, but has some cases for OSX and FreeBSD too.
+
+The `gui_enabled` var controls whether or not to install graphical tools.
+
+## TODO
 
-sets up my preferred dev environment, handy for trying out VMs or spinning up droplets
+- Adjust to work with ansible-pull via a cloud-config userdata like this:
+  >     #cloud-config
+  >      
+  >     packages:
+  >      
+  >     - ansible
+  >     - git
+  >      
+  >     runcmd:
+  >      
+  >     - echo -e "[localhost]\n127.0.0.1 ansible_connection=local" >> /etc/ansible/hosts
+  >     - ssh-keyscan github.com >> /etc/ssh/ssh_known_hosts
+  >     - mkdir /etc/ansible/web
+  >     - ansible-pull -d /etc/ansible/web/ -U <git repo URL>
+- The above will require a git mirror
+