FIX: improve display of "side" docstring title

[12rambau]

Fix #464

There was already an attempt to solve this issue here:

pydata-sphinx-theme/src/pydata_sphinx_theme/assets/styles/content/_lists.scss

Line 12 in 5d52d4e

grid-template-columns: fit-content(30%) minmax(0, 1fr);

We were still loosing a lot of real estate on small screen and for long title there were no space remaining for the content.

In this PR I propose to remove the grid beavior and set the dt tags on top of the dl. It's repsonsive to dark theme and avoid changing the display on small screens:

before:

after:

visible in: https://pydata-sphinx-theme--981.org.readthedocs.build/en/981/examples/api.html#numpy.linalg.eig

let me know what you think

[choldgraf]

Just a quick comment - the docs look good to me!

[choldgraf]

Why move this our of _lists.scss? Wouldn't this also apply to non-API field lists too?

[12rambau]

I thought this modification was specifically build for API field list so I removed it but if it's set to overwrite the behaviour of every field-list I'm happy to set it back

[choldgraf]

I guess the question is whether this would also apply to field lists like in the kitchen sink here:

https://pydata-sphinx-theme.readthedocs.io/en/stable/examples/kitchen-sink/lists.html#field-list

[12rambau]

I didn't know we were supporting this kind of behaviour. To me, it looks good as it is.

[choldgraf]

I'm happy with whatever. If it also applies to field-lists, but primarily applies to API docs, then let's just add a comment like // Note: this also applies to other field lists but is primarily used for API docs

[12rambau]

wait, qui proco here. This modification only applies to API related dt and dl, look at the first very long encapsulating selector, it includes :not(.glossary)

[drammock]

This modification only applies to API related dt and dl, look at the first very long encapsulating selector, it includes :not(.glossary)

Is there a reason not to apply this change to other field lists besides APIs? Consistency seems good to me.

[12rambau]

APIs generated by numpydocs/napoleon were the only problematic ones. So I would not take the risk to change all the others if they are working nicely