diff --git a/README.md b/README.md
index 6c84878..3ee30b1 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,67 @@
-puppet-jira
-===========
+# puppet-jira
+Puppet module authored by Bryce Johnson
 
-Atlassian JIRA Puppet Module
+## Introduction
 
+puppet-jira is a module for Atlassian's Enterprise Issue Tracking and
+project management tool.
+
+## Requirements
+
+### Operating System
+* MacOS: UNSUPPORTED
+* Linux:  RedHat (Debian untested)
+* Windows:  UNSUPPORTED
+### Databases
+* Postgres
+* MySQL
+
+### Package Requirements
+
+* Puppet 2.7.x
+
+* hiera and hiera-puppet
+This puppet module heavily uses hiera-puppet to decouple configuration 
+information from the module itself.  An example is given in jira.yaml
+that you can use to construct your own jira hieradata information.  Params.pp
+is still used since some resource types can't call hiera directly, like file.
+
+* git 1.7.6+ (this module doesn't check, at least yet, just make sure git
+is installed)
+
+* open JDK 1.6 (Don't use 1.7 yet), prefer update 33+
+
+### Before you begin
+It is your responsibility to backup your database.  Especially do so
+if you are installing to an existing installation of jira as this module
+is UNTESTED from with an existing install of jira
+
+You must have your database setup with the account user that the application
+will use.  This information needs to be put in the hiera yaml, for example
+jira.yaml, in your hieradata directory.
+
+Make sure you have a JAVA_HOME and appropriate java installed on your machine.
+Recommended is JDK 1.6u33
+
+Did I mention if you are upgrading, BACKUP your database first? This module 
+makes no warranty on your data, per its license.
+
+### Installation
+
+This puppet module will be downloading the jira zip, extract it into
+/opt/jira/atlassian-jira-$version
+
+A service will also be created for you with chkconfig configured to be on
+so that jira will start up automatically on system start.
+
+You will also need to enter in the directory to your jira-home, which should
+also be kept in the hiera yaml, for example jira.yaml.
+
+Once you have installed the yaml information, then run puppet apply with 
+this module included in the modulepath.
+
+*** Fixes and Future Work
+Please feel free to raise any issues here for fixes.  I'm happy to fix them
+up.  Also feel free to make a pull request for anything so I can hopefully
+get it in.
 
-UNTESTED...DO NOT USE...I am not ready for you master.
\ No newline at end of file