correct some docstrings; move display_notes to utils