adde Javadoc to KMeansClusterer

java/com.sap.sse/src/com/sap/sse/util/kmeans/Cluster.java

@@ -69,6 +69,10 @@ public class Cluster<E, ValueType, AveragesTo, T extends ScalableValueWithDistan
         }
     }
     
+    /**
+     * Determines the {@link ScalableValueWithDistance#getDistance(Object) distance} of the element <code>e</code> to
+     * this cluster's {@link #mean} value.
+     */
     public double getDistanceFromMean(final E e) {
         return mapper.apply(e).getDistance(mean);
     }

java/com.sap.sse/src/com/sap/sse/util/kmeans/KMeansMappingClusterer.java

@@ -131,6 +131,11 @@ public class KMeansMappingClusterer<E, ValueType, AveragesTo, T extends Scalable
         }
     }
     
+    /**
+     * Computes the next iteration by creating new clusters that use as their mean the centroids of the
+     * current clusters; then, assigns all elements to these clusters and repeats this process until
+     * the latest iteration produces the same clustering that the previous iteration produced.
+     */
     private void iterate(Iterable<E> elements) {
         List<Cluster<E, ValueType, AveragesTo, T>> oldClusters;
         do {