Documentation + bug fixes for CRAFTERCMS-465

Includes README.md and fixes for #1 and #2 of:
http://issues.craftercms.org/browse/CRAFTERCMS-465