semantics fix

readme fixes