This docs can be more high-level. Variable names are too specific, and easily get out of sync. Just explain the main idea, the code is pretty clear ;-)