hard to read docs for domain types

[jl-wynen]

The docs that Sphinx renders for domain types are not the most useful. They simply show the docs of the underlying class. This is a bit hard to read. And it can lead to problems with links, see scipp/essdiffraction@8a22410

I suggest we simply show the underlying type with a link to its docs. This may be easy to do with a custom template. But only if we keep domain types in a common module. Otherwise, it's hard to detect what are domain types and what not.

[SimonHeybrock]

Isn't this improved with Python 3.10?

[jl-wynen]

How so? Why would this change how Sphinx renders classes?

[SimonHeybrock]

Because NewType was changed to a class instead of a function with 3.10.

[jl-wynen]

I found this in ESSdiffraction (see link) and I built the docs with 3.10. So it may be the other way around, because NewType is a class, sphinx shows the docs for the underlying class.