Tidy the docs and comments to be explicit about submodules