Docs: use of the language "swift module" is confusing
The docs refer to .swiftmodule
files as “Swift modules,” but these files are really just module interface descriptions. A module's binary artifact consists of that file plus code in some static or shared library. IIUC it is possible that multiple swift modules are linked together into a single library, but in the normal case there is one library per module and that library is as much "the module" as the .swiftmodule
file is. It would be better to refer to these files as “.swiftmodule
files” in the documentation or “Swift module interface description files” (if you must, but that's a mouthful).