diff --git a/README.md b/README.md
new file mode 100644
index 0000000..09a33ca
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# ansible playbook
+
+## Introduction
+
+This is the top level playbook for the 'ansible' role. 
+
+This role will install ansible to the target host using pip3.
+
+This playbook can be run using the following command line;
+
+    ansible-playbook -i <inventory file | IP,> ansible.yml
+
+    ie,
+    ansible-playbook -i 192.168.1.123, ansible.yml
+