Update validation comments

scripts/validate/check-index-contents.js

@@ -74,8 +74,8 @@ class IndexFileDeviceFilesHelper {
 			}
 		}
 
-		console.log('Passed');
-		return 'Passed';
+		console.log('Passed: Index contents');
+		return 'Passed: Index contents';
 	}
 }
 
@@ -98,6 +98,7 @@ deviceFilePathList = walkSync(fsHelper.getBasePathFromDirectoryPath(baseDirector
 	],
 	ignore: [
 		'**/*-tb.v',
+		'docs/**',
 		'images/**',
 		'includes/**',
 		'scripts/**'

scripts/validate/exec-verilog.js

@@ -1,6 +1,7 @@
 // exec-verilog.js
 //
-// - validate every IC device '*.v' by running it through its test bench '*-tb.v'
+// - validate every IC device '*.v' by running it through its test bench '*-tb.v', and
+//   enforce that there is a test bench for every device
 //
 // - argument (optional): top level directory of the project
 //
@@ -42,7 +43,7 @@ class VerilogTestBenchHelper {
 						throw 'No test bench file: ' + testBenchFilePath;
 					}
 
-					// collect the logged output from executing iverilog and vvp externally
+					// collect the logged output from executing command line iverilog and vvp
 					deviceTestOutput = this.execDeviceTests(testBenchFilePath,
 															deviceFilePath,
 															includesDirectoryPath,

scripts/validate/fs-helper.js

@@ -19,7 +19,7 @@ class FsHelper {
 				targetDirectory = defaultDirectory + targetDirectory;
 			}
 
-			// put in canonical form of a directory (acts as a prefix)
+			// put in canonical form of a directory (it will act as a prefix)
 			if (!(targetDirectory.endsWith('/') || targetDirectory.endsWith('\\'))) {
 				targetDirectory = targetDirectory + '/';
 			}