add notes on SemVer
use new hash syntax throughout