second pass on comments, less psuedocode and a bit more useful