improving usage notes