improve error messages; add normalization examples