website: add staticcheck.io website

This adds a new website for Staticcheck. It uses Hugo[1] and the
Docsy[2] theme and is fully open source, unlike the old website.

The only files omitted from this commit are the list of sponsors and
sponsor logos. These are kept out of tree, to keep the repository
small and to avoid unnecessary commits as sponsors come and go.
The website still builds fine without those files, it will only be
missing the sponsors bar at the bottom, as well as the list of
sponsors on the Sponsors page.

To make generating the check documentation easier, lint.Documentation
has gained two new fields, "Before" and "After". These contain before
and after code samples, which were previously part of the "Text"
field.

The website is its own Go module, to prevent its inclusion in the
honnef.co/go/tools module's ZIP. It's part of this repository,
however, so that changes to Staticcheck and its documentation stay in
sync.

[1]: https://gohugo.io/
[2]: https://www.docsy.dev/

Author: dominikh

.gitattributes

@@ -1 +1,2 @@
 *.golden -text
+*.svg binary

.gitignore

@@ -0,0 +1,12 @@
+/cmd/keyify/keyify
+/cmd/staticcheck/staticcheck
+/cmd/structlayout-optimize/structlayout-optimize
+/cmd/structlayout-pretty/structlayout-pretty
+/cmd/structlayout/structlayout
+/dist/20??.?.?/
+/dist/20??.?/
+/internal/cmd/irdump/irdump
+/website/public
+/website/resources
+/website/assets/img/sponsors
+/website/data/sponsors.toml

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "website/themes/docsy"]
+	path = website/themes/docsy
+	url = https://github.com/google/docsy

analysis/lint/lint.go

@@ -58,6 +58,8 @@ const (
 type Documentation struct {
 	Title      string
 	Text       string
+	Before     string
+	After      string
 	Since      string
 	NonDefault bool
 	Options    []string
@@ -66,8 +68,10 @@ type Documentation struct {
 
 func Markdownify(m map[string]*Documentation) map[string]*Documentation {
 	for _, v := range m {
-		v.Title = toMarkdown(v.Title)
-		v.Text = toMarkdown(v.Text)
+		v.Title = strings.TrimSpace(toMarkdown(v.Title))
+		v.Text = strings.TrimSpace(toMarkdown(v.Text))
+		v.Before = strings.TrimSpace(v.Before)
+		v.After = strings.TrimSpace(v.After)
 	}
 	return m
 }
@@ -86,6 +90,22 @@ func (doc *Documentation) String() string {
 	if doc.Text != "" {
 		fmt.Fprintf(b, "%s\n\n", doc.Text)
 	}
+
+	if doc.Before != "" {
+		fmt.Fprintln(b, "Before:")
+		fmt.Fprintln(b, "")
+		for _, line := range strings.Split(doc.Before, "\n") {
+			fmt.Fprint(b, "    ", line, "\n")
+		}
+		fmt.Fprintln(b, "")
+		fmt.Fprintln(b, "After:")
+		fmt.Fprintln(b, "")
+		for _, line := range strings.Split(doc.After, "\n") {
+			fmt.Fprint(b, "    ", line, "\n")
+		}
+		fmt.Fprintln(b, "")
+	}
+
 	fmt.Fprint(b, "Available since\n    ")
 	if doc.Since == "" {
 		fmt.Fprint(b, "unreleased")