add some comments

test/utils.go

@@ -92,7 +92,7 @@ func assertFailures(t *testing.T, baseDir string, fi os.FileInfo, src []byte, ru
 			}
 
 			if in.Match == p.Failure {
-                // check replacement if we are expecting one
+				// check replacement if we are expecting one
 				if in.Replacement != "" {
 					// ignore any inline comments, since that would be recursive
 					r := p.ReplacementLine
@@ -111,8 +111,8 @@ func assertFailures(t *testing.T, baseDir string, fi os.FileInfo, src []byte, ru
 					}
 
 				}
-				
-                // remove this problem from ps
+
+				// remove this problem from ps
 				copy(failures[i:], failures[i+1:])
 				failures = failures[:len(failures)-1]
 
@@ -132,14 +132,15 @@ func assertFailures(t *testing.T, baseDir string, fi os.FileInfo, src []byte, ru
 }
 
 type instruction struct {
-	Line        int    // the line number this applies to
-	Match       string // which pattern to match
-	Replacement string // what the suggested replacement line should be
-	RuleName    string
-	Category    string
-	Confidence  float64
+	Line        int     // the line number this applies to
+	Match       string  // which pattern to match
+	Replacement string  // what the suggested replacement line should be
+	RuleName    string  // what rule we use
+	Category    string  // which category
+	Confidence  float64 // confidence level
 }
 
+// structure used when we parse json object insted of classic MATCH string
 type JsonInstruction struct {
 	Match      string  `json:"MATCH"`
 	Category   string  `json:"Category"`
@@ -226,7 +227,7 @@ func extractInstructionFromJson(line string, lineNumber int) (instruction, error
 
 func extractDataMode(line string) string {
 
-    if strings.HasPrefix(line, "json") {
+	if strings.HasPrefix(line, "json") {
 		return "json"
 	}
 	if strings.Contains(line, "MATCH") {