cleaning up comments and documenting. some refactoring of content in normalize file