checkers: add checkers info fields test (go-critic#794)

Don't permit empty summary or param docs.

Signed-off-by: Iskander Sharipov <[email protected]>

Author: quasilyte

checkers/checkers_test.go

@@ -54,6 +54,20 @@ func TestTags(t *testing.T) {
 	}
 }
 
+func TestDocs(t *testing.T) {
+	for _, info := range lintpack.GetCheckersInfo() {
+		if info.Summary == "" {
+			t.Errorf("%q checker lacks summary", info.Name)
+		}
+		for key, p := range info.Params {
+			if p.Usage == "" {
+				t.Errorf("%q checker %q param lacks usage docs",
+					info.Name, key)
+			}
+		}
+	}
+}
+
 func TestStableList(t *testing.T) {
 	// Verify that new checker is not added without "experimental"
 	// tag by accident. When stable checker is about to be added,

checkers/hexLiteral_checker.go

@@ -14,7 +14,7 @@ func init() {
 	var info lintpack.CheckerInfo
 	info.Name = "hexLiteral"
 	info.Tags = []string{"style", "experimental"}
-	info.Summary = ""
+	info.Summary = "Detects hex literals that have mixed case letter digits"
 	info.Before = `
 x := 0X12
 y := 0xfF`