docs: add migration guide

Author: alexandear

docs/src/config/sidebar.yml

@@ -26,6 +26,8 @@
       link: "/product/thanks/"
     - label: "Changelog"
       link: "/product/changelog/"
+    - label: "Migration Guide"
+      link: "/product/migration-guide/"
     - label: "Roadmap"
       link: "/product/roadmap/"
     - label: "Performance"
@@ -54,4 +56,3 @@
       link: /plugins/module-plugins/
     - label: Go Plugin System
       link: /plugins/go-plugins/
-

docs/src/docs/product/migration-guide.mdx

@@ -0,0 +1,83 @@
+---
+title: Migration guide
+---
+
+## Migrating configuration from v1 to v2
+
+Golangci-lint v2 has slightly different configuration options than v1.
+Some options were renamed, some were moved, and some were removed.
+Here is a guide how to migrate your v1 configuration.
+
+You can use `golangci-lint` itself to migrate your configuration through the `migrate` command:
+
+```sh
+golangci-lint config migrate
+```
+
+In case you want to do it manually, here is a list of changes.
+
+
+### `linters` configuration
+
+### `linters-settings` configuration
+
+### `issues` configuration
+
+#### Removed
+
+*v1*
+
+```yaml
+issues:
+  exclude-case-sensitive: true
+```
+
+*v2*
+
+`issues.exclude` and `issues.exclude-rules` are case sensitive by default.
+
+#### Replaced
+
+##### `exclude-dirs` and `exclude-files` with `exclusions.paths`
+
+*v1*
+
+```yaml
+issues:
+  exclude-dirs:
+    - dir1
+    - dir2
+
+  exclude-files:
+    - file1
+    - file2
+```
+
+*v2*
+
+```yaml
+linters:
+  exclusions:
+    paths:
+      - dir1
+      - dir2
+      - file1
+      - file2
+```
+
+```yaml
+issues:
+  exclude-dirs:
+    - dir1
+    - dir2
+
+  exclude-files:
+    - file1
+    - file2
+```
+
+### `output` configuration
+
+### `run` configuration
+
+### `severity` configuration