Add docs and update timing, see #52

js/local/test.js

@@ -42,7 +42,7 @@ const _ = require( '../../../sherpa/lib/lodash-4.17.4.js' ); // eslint-disable-l
            repo !== 'faradays-law'; // Broken at the moment, see https://github.com/phetsims/faradays-law/issues/147
   } ).map( getUnitTestURL );
 
-  const timeout = 5000;
+  const timeout = 6000; // Timed so it takes about the same length of time as unit tests and linting, at least on my machine!
   const allTests = [];
   const pairs = [];
 

scripts/auto-tests-local.sh

@@ -2,11 +2,18 @@
 # https://www.codeword.xyz/2015/09/02/three-ways-to-script-processes-in-parallel/
 # Run fast local tests as a sanity check before committing or pushing.
 
+# Share the same random seed across instances
 RAND=$RANDOM
+
+# Split unit tests into multiple groups to speed up by parallelism
 node js/local/test.js $RAND 3 0 UNIT &
 node js/local/test.js $RAND 3 1 UNIT &
 node js/local/test.js $RAND 3 2 UNIT &
+
+# Run the long fuzz test on its own, since it takes a while
 node js/local/test.js $RAND 1 0 FUZZ &
+
+# Run linting separately since it takes a while
 grunt lint-everything --repo=faradays-law &
 
 wait