add comments to readme to describe my design decisions