From fb388d02a14764ac122c15497f9c6b5b12c7eb5c Mon Sep 17 00:00:00 2001
From: "Glenn K. Lockwood" <glennklockwood@gmail.com>
Date: Tue, 22 Aug 2017 23:51:24 -0700
Subject: [PATCH] a little better documentation

---
 README.md | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index db1d72a..ff8ee7f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,24 @@
-Self configuration of a fresh Raspbian installation on Raspberry Pi.  This is
-very much a work in progress.
+# Raspberry Pi Ansible
+
+Glenn K. Lockwood, August 2017
+
+## Introduction
+
+This is an Ansible configuration that configures a fresh Raspbian installation
+on Raspberry Pi.  This is very much a work in progress and not intended to be
+used by anyone but me.
+
+## Bootstrapping on Raspbian
+
+If you want to use these playbooks to make a Raspberry Pi self-configure,
+install Ansible by doing the following:
+
+    # apt-get install ansible
+    # pip install --user ansible
+    # ssh-keygen
+    # ssh-copy-id localhost
+
+You can ensure that Ansible is able to configure using the following:
+
+    $ ansible -i hosts all -m ping
+    $ ansible -i hosts -u pi --sudo-user root all -a "/usr/bin/id -u"