update some important comments