Add reminder about docstrings, objects, and intervening lines (#58541)
Added a specific call out (as a reminder note) that no lines are allowed
between docstrings and the object being documented. This is strictly an
addition, with none of the current text being changed.
---------
Co-authored-by: Neven Sajko <4944410+nsajko@users.noreply.github.com>