Forward port 70475:  Add implementation notes.  Put methods in more readable order.
Forward port 70475:  Add implementation notes.  Put methods in more readable order.

sk-/python2.7-type-annotator,sk-/python2.7-type-annotator,sk-/python2.7-type-annotator