add better read me notes, and scale clear