Add in a MD note to the README, plus do some quick cleanup.

Signed-off-by: Ben Stott <bgbnbigben@contextualsystems.com>