Documentation update

Added some more documentation, so that it is more in line with what
Jacob discussed in class on Tuesday, Feb 4 2014.