improve comments

Author: etpinard

test/image/compare_pixels_test.js

@@ -28,9 +28,18 @@ function runAll () {
 
         var files = fs.readdirSync(constants.pathToTestImageMocks);
 
-        // -1 for font-wishlist and
-        // -38 for the gl2d mocks
-        // -1 for gl3d_bunny-hull
+        /*
+         * Some test cases exhibit run-to-run randomness;
+         * skip over a few test cases for now
+         *
+         * More info:
+         * https://github.com/plotly/plotly.js/issues/62
+         *
+         * 40 test case are removed:
+         * - font-wishlist (1 test case)
+         * - all gl2d (38)
+         * - gl2d_bunny-hull (1)
+         */
         t.plan(files.length - 40);
 
         for (var i = 0; i < files.length; i ++) {

test/jasmine/karma.ciconf.js

@@ -8,7 +8,12 @@ function func(config) {
 
     // Continuous Integration mode
 
-    // exclude the WebGL interaction test on circle runs
+    /*
+     * WebGL interaction test cases fail on the CircleCI
+     * most likely due to a WebGL/driver issue;
+     * exclude them from the CircleCI test bundle.
+     *
+     */
     func.defaultConfig.exclude = ['tests/gl_plot_interact_test.js'];
 
     // if true, Karma captures browsers, runs the tests and exits

test/jasmine/tests/gl_plot_interact_test.js

@@ -3,7 +3,7 @@ var d3 = require('d3');
 var Plotly = require('@src/index');
 
 /*
- * The following test cases fail on the CircleCI
+ * WebGL interaction test cases fail on the CircleCI
  * most likely due to a WebGL/driver issue
  *
  */