major revision of README documentation

A major update to the README has been made
to describe this system in more detail and
give examples of its use and operation.