add semantic api aliases + update README