Updated README with information about design descisions.
Merge branch 'master' into dev