Updated readme

Author: cavaliercoder

README.md

@@ -2,12 +2,59 @@
 
 This Python script aims to resolve compatability issues when migrating Zabbix
 template XML files between versions of Zabbix. For example, you may wish to
-import a Zabbix v3.2 template into Zabbix v2.2. This operation will likely fail
-if new features have been implemented in the exported template.
+import a Zabbix v3.2 template into Zabbix v2.0.
+
+The script works by applying conversion rules to a template, which manipulate
+the template XML to match the desired Zabbix version template format.
+
+To convert a Zabbix 3.2 template for import into v2.0:
+
+    $ zabbix-template-convertor -o 2.0 my_template.xml > my_template-2.0.xml
 
 __WARNING__: This project is still under active development and not ready for
              release.
 
+```
+$ zabbix-template-convertor -h
+usage: zabbix-template-convertor [-h] [-v] -o X.Y.Z [-s] file
+
+Migrate Zabbix templates between versions
+
+positional arguments:
+  file                  Zabbix template XML file
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --version         show program's version number and exit
+  -o X.Y.Z, --output-version X.Y.Z
+                        target Zabbix version
+  -s, --squash-value-maps
+                        remove references to value maps for versions older
+                        than 3.0.0
+
+```
+
+
+## Coverage
+
+This project relies heavily on the community to report incompatability problems
+when importing templates. 
+
+__Please raise an issue__ if you find a template that won't import after being
+converted. Be sure to include the error messages and template file.
+
+Over time, as conversion rules are added, the script should become more comprehensive, and more reliable.
+
+
+## Installation
+
+Copy the script file to your bin directory and add the executable flag:
+
+    $ curl -Lo /bin/zabbix-template-convertor \
+        https://raw.githubusercontent.com/cavaliercoder/zabbix-template-convertor/master/zabbix-template-convertor
+    $ chmod +x /bin/zabbix-template-convertor
+
+
 ## License
 
 Copyright (c) 2015 Ryan Armstrong