Update README.md

Adds link to the semantic example and background for the decisions made