Not enough space between list items

[cool-RR]

See this screenshot for documentation that I'm writing as part of PEP 618:

The list item to the right of the cursor is awkward. I think there should be more space between it and the one above it.

[JulienPalard]

This is probably rendered as two distinct lists, can you share the rst we can take a look? Also can you check in the DOM if you see two distinct lists?

[cool-RR]

This has now been merged into Python, so you can see it live here:

https://docs.python.org/3.10/library/functions.html#zip

And you can see the source here: https://raw.githubusercontent.com/python/cpython/master/Doc/library/functions.rst

Search for "Shorter iterables can be padded"

[cool-RR]

Looking at the DOM, I'm not seeing two distinct lists.

[hugovk]

There's extra space between the first and second bullet points because the first one ends with a code block.

Code blocks comes with extra CSS to add space below as part of its div and pre.

To demonstrate, deleting it shows the usual small gap between bullets:

Before	After deleting the code block from the DOM

[cool-RR]

@hugovk I understand, and what I'm saying is that there should be more vertical space between list items, regardless of whether they have code blocks in them or not. This is similar to how there's vertical a space between paragraphs. It helps to tell things apart at a glance.

[hugovk]

Right, there's 1em margin below the code blocks, perhaps something like this would help?

li {
    margin-bottom: 1em;
}

Before	After

[cool-RR]

Yes, that's perfect.

[JulienPalard]

I have a vague, old, souvenir of a time where list composed of only small sentences were not spaced, and list composed of long strings were spaced.

IIRC this "feature" was removed because it caused strange visual inconsistencies, typically when a long list had a single long element, triggering the "need spacing" thing.

So ensure it renders correctly for lists of short sentences, like:

• PEP 584, union operators added to dict;
• PEP 585, type hinting generics in standard collections;
• PEP 614, relaxed grammar restrictions on decorators.

and don't resurect the old bug :) (I searched here, in my emails, and on bugs.python.org and can't find where the issue was reported and fixed, sry. If someone remembers something... please link!)

[pradyunsg]

You can only set that on "simple" lists -- ReStructuredText actually generates a different class for simple (single paragraph) lists and complex (multi paragraph/codeblock etc) lists.

Having a margin for only "simple" lists would be OK in my opinion. See how Sphinx RTD Theme and Furo handle the same, for reference.

[hugovk]

Retesting with https://docs.python.org/3.11/library/functions.html#zip I can no longer reproduce this (Chrome 109 on macOS):

Inspecting, there's now a margin-block-start: 14px before the list item:

Coming from margin-block-start: 1em from the "layer user agent style sheet"

Also looks fine in other browsers.

Safari

Firefox

Opera

And Chrome on Android.

Chrome on Android

Let's close this, and can re-open if it's reproducible on some other browser/OS.

Thanks anyway for the report!

[cool-RR]

Confirmed it doesn't happen on my browser anymore. Thank you.