[deprecated-argument] Create the initial documentation (#8995)

Pierre-Sassoulas · web-flow · commit 20fa2091a27b · 2023-09-07T09:24:21.000+02:00
Refs #5953
diff --git a/doc/data/messages/d/deprecated-argument/bad.py b/doc/data/messages/d/deprecated-argument/bad.py
@@ -0,0 +1 @@
+int(x=1)  # [deprecated-argument]
diff --git a/doc/data/messages/d/deprecated-argument/details.rst b/doc/data/messages/d/deprecated-argument/details.rst
@@ -1,2 +1,8 @@
-The actual replacement need to be studied on a case by case basis
-by reading the deprecation warning or the release notes.
+This message can be raised on your own code using a `custom deprecation checker`_ (follow link for a full example).
+
+Loading this custom checker using ``load-plugins`` would start raising ``deprecated-argument``.
+
+The actual replacement then need to be studied on a case by case basis by reading the
+deprecation warning or the release notes.
+
+.. _`custom deprecation checker`: https://github.com/pylint-dev/pylint/blob/main/examples/deprecation_checker.py
diff --git a/doc/data/messages/d/deprecated-argument/good.py b/doc/data/messages/d/deprecated-argument/good.py
@@ -1 +1 @@
-# This is a placeholder for correct code for this message.
+int(1)
diff --git a/doc/data/messages/d/deprecated-argument/pylintrc b/doc/data/messages/d/deprecated-argument/pylintrc

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-# This is a placeholder for correct code for this message.`
	`1`	`+int(1)`