fix: upgrade to godoclint v0.9.0

This version introduces a new rule, named `deprecated`, which checks the
formatting of deprecation notes in godocs.

Signed-off-by: Babak K. Shandiz <[email protected]>

Author: babakks

.golangci.next.reference.yml

@@ -1292,6 +1292,9 @@ linters:
         # Require godoc for all public symbols.
         # https://github.com/godoc-lint/godoc-lint?tab=readme-ov-file#require-doc
         - require-doc
+        # Assert correct formatting of deprecation notes.
+        # https://github.com/godoc-lint/godoc-lint?tab=readme-ov-file#deprecated
+        - deprecated
         # Assert maximum line length for godocs.
         # https://github.com/godoc-lint/godoc-lint?tab=readme-ov-file#max-len
         - max-len
@@ -1307,6 +1310,7 @@ linters:
         - require-pkg-doc
         - start-with-name
         - require-doc
+        - deprecated
         - max-len
         - no-unused-link
 

go.mod

@@ -45,7 +45,7 @@ require (
 	github.com/go-critic/go-critic v0.13.0
 	github.com/go-viper/mapstructure/v2 v2.4.0
 	github.com/go-xmlfmt/xmlfmt v1.1.3
-	github.com/godoc-lint/godoc-lint v0.8.0
+	github.com/godoc-lint/godoc-lint v0.9.0
 	github.com/gofrs/flock v0.12.1
 	github.com/golangci/asciicheck v0.5.0
 	github.com/golangci/dupl v0.0.0-20250308024227-f665c8d69b32

go.sum

@@ -484,6 +484,7 @@
         "require-pkg-doc",
         "start-with-name",
         "require-doc",
+        "deprecated",
         "max-len",
         "no-unused-link"
       ]

jsonschema/golangci.next.jsonschema.json

@@ -9,8 +9,9 @@ linters:
         - require-pkg-doc
         - start-with-name
         - require-doc
-        - no-unused-link
+        - deprecated
         - max-len
+        - no-unused-link
       options:
         start-with-name:
           include-unexported: true

pkg/golinters/godoclint/testdata/godoclint.yml

@@ -90,3 +90,18 @@ const constWithUnusedLink = 1
 
 // constWithTooLongGodoc has a very long godoc that exceeds the maximum allowed length for godoc comments in this test setup. // want `godoc line is too long \(169 > 127\)`
 const constWithTooLongGodoc = 1
+
+// DeprecatedConstA is... // want `deprecation note should be formatted as "Deprecated: "`
+//
+// DEPRECATED: do not use
+const DeprecatedConstA = 1
+
+// DeprecatedConstB is... // want `deprecation note should be formatted as "Deprecated: "`
+//
+// DEPRECATED:do not use
+const DeprecatedConstB = 1
+
+// DeprecatedConstC is... // want `deprecation note should be formatted as "Deprecated: "`
+//
+// deprecated:do not use
+const DeprecatedConstC = 1

pkg/golinters/godoclint/testdata/godoclint_full_fail.go

@@ -60,3 +60,16 @@ const constWithUnusedLink = 1
 
 // constWithTooLongGodoc has a very long godoc that does not exceed the maximum allowed length for godoc comments.
 const constWithTooLongGodoc = 1
+
+// DeprecatedConstA is...
+//
+// Deprecated: do not use
+const DeprecatedConstA = 1
+
+// Deprecated: do not use
+const DeprecatedConstB = 1
+
+// deprecatedConstC is...
+//
+// DEPRECATED: invalid deprecation note but okay since the symbol is not exported
+const deprecatedConstC = 1

pkg/golinters/godoclint/testdata/godoclint_full_pass.go

@@ -60,3 +60,11 @@ const constWithUnusedLink = 1
 
 // constWithTooLongGodoc has a very long godoc that does not exceed the maximum allowed length for godoc comments.
 const constWithTooLongGodoc = 1
+
+// DeprecatedConstA is...
+//
+// Deprecated: do not use
+const DeprecatedConstA = 1
+
+// Deprecated: do not use
+const DeprecatedConstB = 1