Updated readme

Added basic summary, info on building and notes on the error mechanism
macros.