Merge pull request #113 from noisebridge/superq/update_readme

Update README.

Author: marcidy

README.md

@@ -1,14 +1,18 @@
-# ansible
+# Noisebridge Infrastructure
 
-the noisebridge infrastucture playbooks
+This repo contains configuration and code to deploy Noisebridge infrastrucutre.
 
-## Submodules
+## Ansible
+
+Much of the code here is the Noisebridge infrastucture [Ansible](https://docs.ansible.com/ansible/latest/) configuration. Ansible is used to automatically deploy configuration to the various nodes (VMs and hardware in the space).
+
+### Submodules
 
 This repo includes git submodules to vendor external source.  You need to update them with this helper command.
 
     ./update-submodules.sh
 
-## Deployment
+### Deployment
 
 Deploying the entire thing should be possible with just one command:
 
@@ -17,10 +21,3 @@ Deploying the entire thing should be possible with just one command:
 Usually, you will want to limit your deployment to specific host groups:
 
     ansible-playbook site.yml --limit noisebridge-net
-
-
-## HERE BE DRAGONS
-
-This is an aspirational repository for use to provision future noisebridge
-infrastructure and deprecate our old and tired VMs. It is not currently used
-for production services - don't rely on it as a source of truth for anything.