What gets a docs entry is currently manually determined - e.g. here
This means some things are left out
e.g. cf_units.CALENDARS appears in docs, but cf_units.CALENDAR_360_DAY does not, even though it is included in __all__ .
If things ought to be private, we should apply the standard dunder / all control for it.
Possible solutions are sphinx-autoapi or sphinx-apidoc+autodoc
Hints : Iris might be switching to autoapi, and geovista is already there (natch!)
What gets a docs entry is currently manually determined - e.g. here This means some things are left out e.g.
cf_units.CALENDARSappears in docs, butcf_units.CALENDAR_360_DAYdoes not, even though it is included in__all__.If things ought to be private, we should apply the standard dunder / all control for it.
Possible solutions are sphinx-autoapi or sphinx-apidoc+autodoc Hints : Iris might be switching to autoapi, and geovista is already there (natch!)