improve the comments in the editable listing