Sphinx puts class properties in odd places on the page

[pp-mo]

We seemed to have a problem with Sphinx putting multiple class parameters on one line, sometimes with really rather nasty effect ...
E.G https://scitools-iris.readthedocs.io/en/v3.2.1/generated/api/iris/common/mixin.html#iris.common.mixin.CFVariableMixin.attributes)
(which is really a bit of a car-crash)

This example is notable for re-appearing in all the inheriting classes, but the appearance varies,
E.G. https://scitools-iris.readthedocs.io/en/v3.2.1/generated/api/iris/coords.html#iris.coords.CellMeasure.standard_name

I don't really have any clue why this is or when it started, but possibly it came in with the Napoleon extension??

I did wonder if we could stop it by just ensuring blank lines between them, but it looks like we already have that.
https://github.com/SciTools/iris/blob/main/lib/iris/common/mixin.py#L148-L167

[tkknight]

The new pydata theme adoption appears to alleviate this for mixin but looks the same for coords.

• mixin v3.2.1 vs latest
• coords v3.2.1 vs latest

I think the spacing in the comments varies across our codebase that can cause inconsistencies in how it is rendered. The custom API generation may not be helping too.

[pp-mo]

new pydata theme adoption appears to alleviate this for mixin but looks the same for coords.

For me, it seemed to have also fixed the problem I highlighted for CellMeasure, and maybe is entirely OK now ?
The pink highlighting makes individual items stand out much clearer, too. 👍

[tkknight]

I suggest we can close this issue now @pp-mo ?