Possible solution:

Create a python file with the following contents and add to sphinx project:

`# sphinx_initvar_filter.py
from sphinx.ext.autodoc import ClassDocumenter, ModuleLevelDocumenter
from sphinx.util.inspect import getdoc
from sphinx.util import logging

logger = logging.getLogger(name)

class InitVarFilterDocumenter(ClassDocumenter):
def add_directive_header(self, sig):
self.options.noindex = True
super().add_directive_header(sig)
self.options.noindex = False

def filter_members(self, members, want_all):
    filtered_members = []
    for name, obj in members:
        if not name.startswith('__') and 'InitVar' not in str(obj):
            filtered_members.append((name, obj))
        else:
            logger.info(f'Filtering out: {name} ({obj})')
    return filtered_members

def setup(app):
app.add_autodocumenter(InitVarFilterDocumenter)`

Then modify conf.py to include the custom operation:

`# conf.py
extensions = [
'sphinx.ext.autodoc',
'sphinx_autodoc_typehints',
'sphinx.ext.napoleon',
'sphinx_initvar_filter' # Add your custom extension here
]

autodoc_typehints = "description"
autodoc_typehints_format = "short"`

Hasn't been tried and tested yet

also more in pressure submodule:

I suspect this might be linked in to the state of our nitpick_ignore settings in the sphinx conf.py, which is a total dumpster fire of things that sphinx moans about.

This looks relevant:
https://stackoverflow.com/questions/67473396/shorten-display-format-of-python-type-annotations-in-sphinx

Nice find.

is there a simple way to build the docs locally to test the changes?

Should be able just to do cd docs; poetry run make html. All the requirements for docs are included in the poetry requirements. It doesn't seem to work though 😢

Should be able just to do cd docs; poetry run make html. All the requirements for docs are included in the poetry requirements. It doesn't seem to work though 😢

It does work for me.

Hm, I tried adding

autodoc_typehints_format = 'short'
python_use_unqualified_type_names = True

to conf.py , running sphinx-apidoc, and a couple of other things suggested on stackoverflow&Co, but it seems to make no difference whatsoever. I am wondering whether I need to regenerate something further down?