Ignore D412 (blank-lines-between-header-and-content) if a reStructuredText directive follows a section header

[harupy]

Originally found in pytest-dev/pytest#12375 where I was trying to fix pytest's API reference. The following code violates D412, but sphinx doesn't render the docstring correctly if the blank line after Example: is removed.

# violates D412

def f():
    """
    Example:

    .. code-block:: python

        import foo
    """

Autofixed code:

# doesn't violate D412, but sphinx fails to render correctly

def f():
    """
    Example:
    .. code-block:: python

        import foo
    """

Repro on playground: https://play.ruff.rs/b4c94827-8503-4568-978d-59e74a31a01b

[charliermarsh]

We could disable D412 enforcement when followed by a Sphinx code block?

[harupy]

@charliermarsh Thanks for the comment! I think any directive can cause the same issue. For example:

def f():
    """
    Example:
    .. note::

        This example only works on windows.

    .. code-block:: python

        import foo
    """

---

update: tested this:

[dhruvmanila]

I think this is resolved by #11609, @charliermarsh feel free to re-open if it's not complete.