The readthedocs build imports self by installing the latest previous version of the package from pypi. This causes a problem where the code structure has changed between iterations, for example in the PR for multi-tld gravity models in caf.distribute there is a new module called 'multi_area.py' which is imported for some documentation. Where caf.distribute is installed from pypi this module doesn't exist so the build fails.
Possible solutions:
sort out the imports in caf packages as proper relative imports where now they assume self is an installed package
work out how to properly mock imports in documentation (sphinx/readthedocs imports everything but doesn't actually need the imports just to get the docstrings, so these imports can be mocked)
The readthedocs build imports self by installing the latest previous version of the package from pypi. This causes a problem where the code structure has changed between iterations, for example in the PR for multi-tld gravity models in caf.distribute there is a new module called 'multi_area.py' which is imported for some documentation. Where caf.distribute is installed from pypi this module doesn't exist so the build fails.
Possible solutions: