[int] better document and rewrite submodule import decisions

[int] better document and rewrite submodule import decisions #102