Update README.md

More usage, and documentation of the design decisions made.