improved comments in example