Add a little more info to the template file.

js/tests/template.js

@@ -22,14 +22,30 @@
  *  Author:             ** replace with your e-mail address **
  */
 
-    var SECTION = "";          // if ECMA test, provide section number
-    var VERSION = "ECMA_2";    // Version of JavaScript or ECMA
-    var TITLE   = "";          // Provide ECMA section title or description
-    var BUGNUMBER = "";        // Provide URL to bugsplat or bugzilla report
+    var SECTION = "";       // provide a document reference (ie, ECMA section)
+    var VERSION = "ECMA_2"; // Version of JavaScript or ECMA
+    var TITLE   = "";       // Provide ECMA section title or a description
+    var BUGNUMBER = "";     // Provide URL to bugsplat or bugzilla report
 
     startTest();               // leave this alone
 
+    /*
+     * Calls to AddTestCase here. AddTestCase is a function that is defined
+     * in shell.js and takes three arguments:
+     * - a string representation of what is being tested
+     * - the expected result
+     * - the actual result
+     *
+     * For example, a test might look like this:
+     *
+     * var zip = /[\d]{5}$/;
+     *
+     * AddTestCase(
+     * "zip = /[\d]{5}$/; \"PO Box 12345 Boston, MA 02134\".match(zip)",   // description of the test
+     *  "02134",                                                           // expected result
+     *  "PO Box 12345 Boston, MA 02134".match(zip) );                      // actual result
+     *
+     */
 
-    /* Calls to AddTestCase here */
-
-    test();                    // leave this alone
+    test();       // leave this alone.  this executes the test cases and
+                  // displays results.