DOC: Described new class docstring and constructor GL08 interaction

Author: mattgebert

doc/format.rst

@@ -557,7 +557,8 @@ Class docstring
 Use the same sections as outlined above (all except :ref:`Returns <returns>`
 are applicable).  The constructor (``__init__``) should also be documented
 here, the :ref:`Parameters <params>` section of the docstring details the
-constructor's parameters.
+constructor's parameters. The class docstring does not need to be repeated
+in a constructor, but is optional.
 
 An **Attributes** section, located below the :ref:`Parameters <params>`
 section, may be used to describe non-method attributes of the class::

doc/validation.rst

@@ -183,6 +183,9 @@ inline comments:
         def __init__(self):  # numpydoc ignore=GL08
             pass
 
+Note, if the :ref:`class <_classdoc>` docstring properly documents the
+constructor, the ``GL08`` will be ignored by default.
+
 This is supported by the :ref:`CLI <validation_via_cli>`,
 :ref:`pre-commit hook <pre_commit_hook>`, and
 :ref:`Sphinx extension <validation_during_sphinx_build>`.