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?

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"

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

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

@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.

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

li {
    margin-bottom: 1em;
}

Before	After

Yes, that's perfect.

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!)