corrections for HOW_TO_EDIT following Jon remarks