chore: remove usage section

ldez · ldez · commit 4d80a2604c59 · 2025-08-03T11:52:32.000+02:00
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -13,7 +13,7 @@ body:
           required: true
         - label: Yes, I've read the `typecheck` section of the [FAQ](https://golangci-lint.run/welcome/faq/#why-do-you-have-typecheck-errors).
           required: true
-        - label: Yes, I've tried with the standalone [linter](https://golangci-lint.run/usage/linters/) if available (e.g., gocritic, go vet, etc.).
+        - label: Yes, I've tried with the standalone [linter](https://golangci-lint.run/linters/) if available (e.g., gocritic, go vet, etc.).
           required: true
         - label: I agree to follow this project's [Code of Conduct](https://github.com/golangci/golangci-lint?tab=coc-ov-file)
           required: true
diff --git a/.golangci.next.reference.yml b/.golangci.next.reference.yml
@@ -11,7 +11,7 @@ version: "2"
 linters:
   # Default set of linters.
   # The value can be:
-  # - `standard`: https://golangci-lint.run/usage/linters/#enabled-by-default
+  # - `standard`: https://golangci-lint.run/linters/#enabled-by-default
   # - `all`: enables all linters by default.
   # - `none`: disables all linters by default.
   # - `fast`: enables only linters considered as "fast" (`golangci-lint help linters --json | jq '[ .[] | select(.fast==true) ] | map(.name)'`).
diff --git a/.golangci.reference.yml b/.golangci.reference.yml
@@ -11,7 +11,7 @@ version: "2"
 linters:
   # Default set of linters.
   # The value can be:
-  # - `standard`: https://golangci-lint.run/usage/linters/#enabled-by-default
+  # - `standard`: https://golangci-lint.run/linters/#enabled-by-default
   # - `all`: enables all linters by default.
   # - `none`: disables all linters by default.
   # - `fast`: enables only linters considered as "fast" (`golangci-lint help linters --json | jq '[ .[] | select(.fast==true) ] | map(.name)'`).
diff --git a/docs/content/_index.md b/docs/content/_index.md
@@ -45,20 +45,20 @@ params:
     title="Nice outputs"
     subtitle="Text with colors and source code lines, JSON, tab, HTML, Checkstyle, Code-Climate, JUnit-XML, TeamCity, SARIF."
     style="background: radial-gradient(ellipse at 50% 80%,rgba(221,210,59,0.15),hsla(0,0%,100%,0));"
-    link="/docs/usage/configuration/file/#output-configuration" >}}
+    link="/docs/configuration/file/#output-configuration" >}}
   {{< hextra/feature-card
     icon="eye-off"
     title="Minimum number of false positives"
     subtitle="Tuned default settings."
-    link="/docs/usage/linters/false-positives" >}}
+    link="/docs/linters/false-positives" >}}
   {{< hextra/feature-card
     icon="collection"
     title="A lot of linters"
     subtitle="No need to install them."
-    link="/docs/usage/linters" >}}
+    link="/docs/linters" >}}
   {{< hextra/feature-card
     icon="document-text"
     title="YAML-based configuration"
     subtitle="Easy to read and maintain."
-    link="/docs/usage/configuration/file" >}}
+    link="/docs/configuration/file" >}}
 {{< /hextra/feature-grid >}}
diff --git a/docs/content/docs/_index.md b/docs/content/docs/_index.md
@@ -15,12 +15,12 @@ title: 'Golangci-lint Documentation'
     subtitle="Get ready to use golangci-lint"
     icon="arrow-circle-right" >}}
 {{< card
-    link="/docs/usage/linters"
+    link="/docs/linters"
     title="Linters"
     subtitle="List of all the linters"
     icon="arrow-circle-right" >}}
 {{< card
-    link="/docs/usage/formatters"
+    link="/docs/formatters"
     title="Formatters"
     subtitle="List of all the formatters"
     icon="arrow-circle-right" >}}
diff --git a/docs/content/docs/configuration/_index.md b/docs/content/docs/configuration/_index.md
@@ -1,8 +1,6 @@
 ---
 title: Configuration
-weight: 1
-sidebar:
-  open: true
+weight: 2
 ---
 
 The config file has lower priority than command-line options.
@@ -13,8 +11,8 @@ Slice options (e.g. list of enabled/disabled linters) are combined from the comm
 ## More
 
 {{< cards cols=2 >}}
-  {{< card link="/docs/usage/configuration/cli" title="Command Line" icon="terminal" >}}
-  {{< card link="/docs/usage/configuration/file" title="Configuration File" icon="adjustments" >}}
+  {{< card link="/docs/configuration/cli" title="Command Line" icon="terminal" >}}
+  {{< card link="/docs/configuration/file" title="Configuration File" icon="adjustments" >}}
 {{< /cards >}}
 
 
diff --git a/docs/content/docs/configuration/cli.md b/docs/content/docs/configuration/cli.md
diff --git a/docs/content/docs/configuration/file.md b/docs/content/docs/configuration/file.md
diff --git a/docs/content/docs/contributing/_index.md b/docs/content/docs/contributing/_index.md
@@ -1,6 +1,6 @@
 ---
 title: Contributing
-weight: 4
+weight: 6
 ---
 
 {{< cards >}}
diff --git a/docs/content/docs/formatters/_index.md b/docs/content/docs/formatters/_index.md
@@ -1,9 +1,7 @@
 ---
 title: Formatters
-weight: 3
+weight: 4
 excludeSearch: true
-sidebar:
-  open: true
 ---
 
 To see a list of supported formatters and which formatters are enabled/disabled:
diff --git a/docs/content/docs/formatters/configuration.md b/docs/content/docs/formatters/configuration.md
diff --git a/docs/content/docs/linters/_index.md b/docs/content/docs/linters/_index.md
@@ -1,9 +1,7 @@
 ---
 title: Linters
-weight: 2
+weight: 3
 excludeSearch: true
-sidebar:
-  open: true
 ---
 
 To see a list of supported linters and which linters are enabled/disabled:
diff --git a/docs/content/docs/linters/configuration.md b/docs/content/docs/linters/configuration.md
diff --git a/docs/content/docs/linters/false-positives.md b/docs/content/docs/linters/false-positives.md
diff --git a/docs/content/docs/plugins/_index.md b/docs/content/docs/plugins/_index.md
@@ -1,6 +1,6 @@
 ---
 title: Plugins
-weight: 5
+weight: 7
 ---
 
 {{< cards >}}
diff --git a/docs/content/docs/product/_index.md b/docs/content/docs/product/_index.md
@@ -1,6 +1,6 @@
 ---
 title: Product
-weight: 3
+weight: 5
 ---
 
 {{< cards cols=2 >}}
diff --git a/docs/content/docs/product/migration-guide.md b/docs/content/docs/product/migration-guide.md
@@ -15,7 +15,7 @@ Be aware that **comments inside a configuration file are not migrated.** You nee
 
 **Deprecated options from v1 or unknown fields are not migrated.**
 
-The migration file format is based on the extension of the [configuration file](/docs/usage/configuration/file).
+The migration file format is based on the extension of the [configuration file](/docs/configuration/file).
 The format can be overridden by using the `--format` flag:
 
 ```bash
diff --git a/docs/content/docs/usage/_index.md b/docs/content/docs/usage/_index.md
diff --git a/docs/content/docs/welcome/quick-start.md b/docs/content/docs/welcome/quick-start.md
@@ -41,7 +41,7 @@ Pass `-E/--enable` to enable linter and `-D/--disable` to disable:
 golangci-lint run --default=none -E errcheck
 ```
 
-More information about available linters can be found in the [linters page](/docs/usage/linters/).
+More information about available linters can be found in the [linters page](/docs/linters/).
 
 ## Formatting
 
@@ -58,4 +58,4 @@ golangci-lint fmt dir1 dir2/...
 golangci-lint fmt file1.go
 ```
 
-More information about available formatters can be found in the [formatters page](/docs/usage/formatters/).
+More information about available formatters can be found in the [formatters page](/docs/formatters/).
diff --git a/docs/hugo.yaml b/docs/hugo.yaml
@@ -50,10 +50,10 @@ menu:
         color: green
     - identifier: linters
       name: Linters
-      pageRef: /docs/usage/linters/
+      pageRef: /docs/linters/
       weight: 3
     - name: Formatters
-      pageRef: /docs/usage/formatters/
+      pageRef: /docs/formatters/
       weight: 4
     - name: Search
       weight: 5
diff --git a/scripts/website/expand_templates/linters.go b/scripts/website/expand_templates/linters.go
@@ -66,7 +66,7 @@ func getLintersListMarkdown(enabled bool, src, section, latestVersion string) st
 
 	for _, lc := range neededLcs {
 		cards.Add(internal.NewCard().
-			Link(fmt.Sprintf("/docs/usage/%s/configuration/#%s", section, lc.Name)).
+			Link(fmt.Sprintf("/docs/%s/configuration/#%s", section, lc.Name)).
 			Title(lc.Name).
 			Subtitle(getDesc(lc)).
 			Tag(getTag(lc, latestVersion)),
@@ -312,11 +312,11 @@ func (e *ExampleSnippetsExtractor) extractExampleSnippets(example []byte) (*Sett
 			builder.WriteString(internal.NewCards().
 				Cols(2).
 				Add(internal.NewCard().
-					Link(fmt.Sprintf("/docs/usage/%s", node.Value)).
+					Link(fmt.Sprintf("/docs/%s", node.Value)).
 					Title(string(baseTitle) + " Overview").
 					Icon("collection")).
 				Add(internal.NewCard().
-					Link(fmt.Sprintf("/docs/usage/%s/configuration", node.Value)).
+					Link(fmt.Sprintf("/docs/%s/configuration", node.Value)).
 					Title(string(baseTitle) + "  Settings").
 					Icon("adjustments")).
 				String())
