diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2b7306db69d948671e1b0ac026b9f9bc9cc12fef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Information Lifecycle Managment (ILM) via GPFS policy engine
+
+The GPFS policy engine is well described in this [white paper](https://www.ibm.com/support/pages/system/files/inline-files/Spectrum%20Scale%20ILM%20Policies_v10.2.pdf).
+A good presentation overview of the policy file is [here](https://www.spectrumscaleug.org/event/ssugdigital-spectrum-scale-ilm-policy-engine/).
+The relavent [documentation is available from IBM](https://www.ibm.com/docs/en/spectrum-scale/4.2.0?topic=guide-information-lifecycle-management-spectrum-scale).
+
+This project focuses on scheduled execution of lifecyle policies.
+
+A policy is executed via the run_job
+
+submit-pol-job <outdir> <policy> <nodecount> <corespernode> <ram> <partition>
+
+Where:
+
+outdir - the directory for the policy and job output, should be global to cluster
+policy - path to the policy file
+nodecount - number of nodes in the cluster that will run the policy
+corespernode - number of cores on each node to reserve
+partition - the partition used to submit the job
+
+The policy run can be scheduled automatically with the cronwrapper script.
+Simpley add append the above script and arguments to the crownwrapper in a crontab line.
+For example to run it every morning at 4 am you would add:
+
+0 4 * * * /path/to/cronwrapper submit-pol-job <outdir> <policy> <nodecount> <corespernode> <ram> <partition>