If an init.py file contains an __all__ array, I think it should document those attributes on that module. There could even be an option to not document that attribute in it's full path. eg If pkg1's init.py file contains an all with pkg1.pkg2.pkg3.MyClass, MyClass should get documented on pkg1, and optionally not on pkg1.pkg2.pkg3.
If an init.py file contains an
__all__array, I think it should document those attributes on that module. There could even be an option to not document that attribute in it's full path. eg If pkg1's init.py file contains an all withpkg1.pkg2.pkg3.MyClass,MyClassshould get documented on pkg1, and optionally not onpkg1.pkg2.pkg3.Does this sound like a reasonable idea?