Updates outdated docs

Author: Josh Deffibaugh

core-api/src/main/java/com/optimizely/ab/Optimizely.java

@@ -96,8 +96,6 @@ private Optimizely(@Nonnull ProjectConfig projectConfig,
 
     // Do work here that should be done once per Optimizely lifecycle
     @VisibleForTesting void initialize() {
-        // Give users of ExperimentRegistry a chance to clean out old state for experiments
-        // that are no longer in the data file.
         bucketer.cleanUserExperimentRecord();
     }
 

core-api/src/main/java/com/optimizely/ab/bucketing/Bucketer.java

@@ -217,6 +217,10 @@ public UserExperimentRecord getUserExperimentRecord() {
         return userExperimentRecord;
     }
 
+    /**
+     * Gives implementations of {@link UserExperimentRecord} a chance to remove records
+     * of experiments that are deleted or not running.
+     */
     public void cleanUserExperimentRecord() {
         if (userExperimentRecord != null) {
             Map<String,Map<String,String>> records = userExperimentRecord.records();