Improve documentation of ``docparams`` extension and fix tests (#5095)

This closes #4136

1 files changed, 3 insertions, 0 deletions

diff --git a/pylint/extensions/docparams.rst b/pylint/extensions/docparams.rst
index e46c4dcd7..e9e0eea00 100644
--- a/pylint/extensions/docparams.rst
+++ b/pylint/extensions/docparams.rst
@@ -90,6 +90,9 @@ You'll be notified of **missing parameter documentation** but also of
 **naming inconsistencies** between the signature and the documentation which
 often arise when parameters are renamed automatically in the code, but not in
 the documentation.
+**Note:** by default docstrings of private and magic methods are not checked.
+To change this behaviour (for example, to also check ``__init__``) add
+``no-docstring-rgx=^(?!__init__$)_`` to the ``BASIC`` section of your ``.pylintrc``.
 
 Constructor parameters can be documented in either the class docstring or
 the ``__init__`` docstring, but not both::