modify some names
format and add some note

Does the python PEP8 autoformat's style look good?