pylint-dev · Pierre-Sassoulas · Feb 22, 2023 · Feb 22, 2023 · Feb 22, 2023
diff --git a/doc/data/messages/s/suppressed-message/bad.py b/doc/data/messages/s/suppressed-message/bad.py
@@ -0,0 +1,9 @@
+### This is a contrived example, to show how suppressed-message works.
+### First we enable all messages
+# pylint: enable=all
+
+### Here we disable two messages so we get two warnings
+# pylint: disable=locally-disabled, useless-suppression # [suppressed-message, suppressed-message]
+
+### Here we disable a message, so we get a warning for suppressed-message again.
+"A"  # pylint: disable=pointless-statement # [suppressed-message, suppressed-message]
diff --git a/doc/data/messages/s/suppressed-message/details.rst b/doc/data/messages/s/suppressed-message/details.rst
@@ -1 +1,4 @@
-You can help us make the doc better `by contributing <https://github.com/PyCQA/pylint/issues/5953>`_ !
+``suppressed-message`` is simply a way to see messages that would be raised
+without the disable in your codebase. It should not be activated most
+of the time. See also ``useless-suppression`` if you want to see the message
+that are disabled for no reasons.
diff --git a/doc/data/messages/s/suppressed-message/good.py b/doc/data/messages/s/suppressed-message/good.py
@@ -1 +1 @@
-# This is a placeholder for correct code for this message.
+"""Instead of a single string somewhere in the file, write a module docstring!"""
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		# This is a placeholder for correct code for this message.
		"""Instead of a single string somewhere in the file, write a module docstring!"""