edits to docs including update of k-means, algo notes, minor corrections