Restore conversion of raw documentation to plain text and Markdown

This fixes a regression introduced in
8643e6e.

Closes: gh-1544

Author: dominikh

add-check.go

@@ -29,7 +29,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run: run,
 		Requires: []*analysis.Analyzer{},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title: "",
 		Text: {{.emptyRaw}},
 		{{- if .quickfix }}

analysis/lint/lint.go

@@ -17,12 +17,12 @@ type Analyzer struct {
 	// The analyzer's documentation. Unlike go/analysis.Analyzer.Doc,
 	// this field is structured, providing access to severity, options
 	// etc.
-	Doc      *Documentation
+	Doc      *RawDocumentation
 	Analyzer *analysis.Analyzer
 }
 
 func InitializeAnalyzer(a *Analyzer) *Analyzer {
-	a.Analyzer.Doc = a.Doc.String()
+	a.Analyzer.Doc = a.Doc.Compile().String()
 	a.Analyzer.URL = "https://staticcheck.dev/docs/checks/#" + a.Analyzer.Name
 	a.Analyzer.Requires = append(a.Analyzer.Requires, tokenfile.Analyzer)
 	return a
@@ -76,26 +76,22 @@ type Documentation struct {
 	MergeIf    MergeStrategy
 }
 
-func Markdownify(m map[string]*RawDocumentation) map[string]*Documentation {
-	out := make(map[string]*Documentation, len(m))
-	for k, v := range m {
-		out[k] = &Documentation{
-			Title: strings.TrimSpace(stripMarkdown(v.Title)),
-			Text:  strings.TrimSpace(stripMarkdown(v.Text)),
-
-			TitleMarkdown: strings.TrimSpace(toMarkdown(v.Title)),
-			TextMarkdown:  strings.TrimSpace(toMarkdown(v.Text)),
-
-			Before:     strings.TrimSpace(v.Before),
-			After:      strings.TrimSpace(v.After),
-			Since:      v.Since,
-			NonDefault: v.NonDefault,
-			Options:    v.Options,
-			Severity:   v.Severity,
-			MergeIf:    v.MergeIf,
-		}
+func (doc RawDocumentation) Compile() *Documentation {
+	return &Documentation{
+		Title: strings.TrimSpace(stripMarkdown(doc.Title)),
+		Text:  strings.TrimSpace(stripMarkdown(doc.Text)),
+
+		TitleMarkdown: strings.TrimSpace(toMarkdown(doc.Title)),
+		TextMarkdown:  strings.TrimSpace(toMarkdown(doc.Text)),
+
+		Before:     strings.TrimSpace(doc.Before),
+		After:      strings.TrimSpace(doc.After),
+		Since:      doc.Since,
+		NonDefault: doc.NonDefault,
+		Options:    doc.Options,
+		Severity:   doc.Severity,
+		MergeIf:    doc.MergeIf,
 	}
-	return out
 }
 
 func toMarkdown(s string) string {

lintcmd/cmd.go

@@ -119,7 +119,7 @@ func (cmd *Command) AddBareAnalyzers(as ...*analysis.Analyzer) {
 			text = a.Doc[idx+2:]
 		}
 
-		doc := &lint.Documentation{
+		doc := &lint.RawDocumentation{
 			Title:    title,
 			Text:     text,
 			Severity: lint.SeverityWarning,
@@ -330,7 +330,7 @@ func (cmd *Command) listChecks() int {
 	for _, c := range cs {
 		var title string
 		if c.Doc != nil {
-			title = c.Doc.Title
+			title = c.Doc.Compile().Title
 		}
 		fmt.Printf("%s %s\n", c.Analyzer.Name, title)
 	}
@@ -353,7 +353,7 @@ func (cmd *Command) explain() int {
 		fmt.Fprintln(os.Stderr, explain, "has no documentation")
 		return 1
 	}
-	fmt.Println(check.Doc)
+	fmt.Println(check.Doc.Compile())
 	fmt.Println("Online documentation\n    https://staticcheck.dev/docs/checks#" + check.Analyzer.Name)
 	return 0
 }

lintcmd/sarif.go

@@ -251,27 +251,28 @@ func (o *sarifFormatter) Format(checks []*lint.Analyzer, diagnostics []diagnosti
 		}},
 	}
 	for _, c := range checks {
+		doc := c.Doc.Compile()
 		run.Tool.Driver.Rules = append(run.Tool.Driver.Rules,
 			sarif.ReportingDescriptor{
 				// We don't set Name, as Name and ID mustn't be identical.
 				ID: c.Analyzer.Name,
 				ShortDescription: sarif.Message{
-					Text:     c.Doc.Title,
-					Markdown: c.Doc.TitleMarkdown,
+					Text:     doc.Title,
+					Markdown: doc.TitleMarkdown,
 				},
 				HelpURI: "https://staticcheck.dev/docs/checks#" + c.Analyzer.Name,
 				// We use our markdown as the plain text version, too. We
 				// use very little markdown, primarily quotations,
 				// indented code blocks and backticks. All of these are
 				// fine as plain text, too.
 				Help: sarif.Message{
-					Text:     sarifFormatText(c.Doc.Format(false)),
-					Markdown: sarifFormatText(c.Doc.FormatMarkdown(false)),
+					Text:     sarifFormatText(doc.Format(false)),
+					Markdown: sarifFormatText(doc.FormatMarkdown(false)),
 				},
 				DefaultConfiguration: sarif.ReportingConfiguration{
 					// TODO(dh): we could figure out which checks were disabled globally
 					Enabled: true,
-					Level:   sarifLevel(c.Doc.Severity),
+					Level:   sarifLevel(doc.Severity),
 				},
 			})
 	}

quickfix/qf1001/qf1001.go

@@ -21,7 +21,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      CheckDeMorgan,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title:    "Apply De Morgan's law",
 		Since:    "2021.1",
 		Severity: lint.SeverityHint,

quickfix/qf1002/qf1002.go

@@ -22,7 +22,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      run,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title: "Convert untagged switch to tagged switch",
 		Text: `
 An untagged switch that compares a single variable against a series of

quickfix/qf1003/qf1003.go

@@ -22,7 +22,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      run,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title: "Convert if/else-if chain to tagged switch",
 		Text: `
 A series of if/else-if checks comparing the same variable against

quickfix/qf1004/qf1004.go

@@ -22,7 +22,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      run,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title:    `Use \'strings.ReplaceAll\' instead of \'strings.Replace\' with \'n == -1\'`,
 		Since:    "2021.1",
 		Severity: lint.SeverityHint,

quickfix/qf1005/qf1005.go

@@ -23,7 +23,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      run,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title:    `Expand call to \'math.Pow\'`,
 		Text:     `Some uses of \'math.Pow\' can be simplified to basic multiplication.`,
 		Before:   `math.Pow(x, 2)`,

quickfix/qf1006/qf1006.go

@@ -21,7 +21,7 @@ var SCAnalyzer = lint.InitializeAnalyzer(&lint.Analyzer{
 		Run:      run,
 		Requires: []*analysis.Analyzer{inspect.Analyzer},
 	},
-	Doc: &lint.Documentation{
+	Doc: &lint.RawDocumentation{
 		Title: `Lift \'if\'+\'break\' into loop condition`,
 		Before: `
 for {