API reference: namespacing is confusing

[Huite]

As mentioned by @VermeulenPTM:

The handwritten API reference shows:

However, the individual method shows:

So there's a discrepancy between imod.idf.open and imod.formats.idf.open.

I did a little checking, e.g. xarray has the same for e.g. the groupby objects: (https://docs.xarray.dev/en/stable/generated/xarray.core.groupby.DatasetGroupBy.html#xarray.core.groupby.DatasetGroupBy).html#xarray.core.groupby.DatasetGroupBy

[Huite]

Somewhat to my surprise, this only shows up in the I/O methods for us.

My current explanation is that for all the other namespaces, we are importing individual function/classes (i.e. Python objects) via from imod.prepare.regridder import Regridder versus a module via from imod.formats import idf.

[Huite]

This stackoverflow question seems to have the same goal in mind: https://stackoverflow.com/questions/56137571/change-the-name-of-a-module-in-python-sphinxs-autodoc#:~:text=I%20am%20looking%20to%20autodoc%20some%20functions