Update README file

This replaces the README file with a new, improved README.md
file written in markdown which contains more infomation and a
simple example.