haddock-docs: Warn about separating lists, use snippets
I've added a warning about separating lists from prior content with at least one blank line and I've added snippets to show the rendered output for haddock markup for lists. Here's how it renders with the changes:
-
This MR relates to #25220 -
I have read the CONTRIBUTING guide -
I have inserted a CHANGELOG entry if this warrants it -
I have squashed my commits -
I have added tests if necessary -
I have updated the documentation