Explicitly forbid including modules in other modules

[tradej]

The documentation currently does not contain an explicit note that modules may not directly include:: other modules (i. e. only assemblies can do that). This has come up a few times, so I believe it warrants and explicit mention somewhere, e. g. in the module definition.

[theashiot]

Hi @tradej, @emmurphy1,

I've identified the following places where we can add a line stating modules can not include other modules:

https://redhat-documentation.github.io/modular-docs/#what-modular-documentation-is After the sentence "An assembly can also include other assemblies", we can have a line "Modules can not include other modules".

https://redhat-documentation.github.io/modular-docs/#_creating_modules We can have an admonition here stating modules can not include other modules.

What do you think?

best,

ashwin

[tradej]

Thank you @theashiot, I believe both places are suitable.

[emmurphy1]

https://github.com/redhat-documentation/modular-docs/pull/161

[thatdocslady]

161

Looks like this PR fixed the issue, recommending to close.

[emmurphy1]

Yes, thanks @thatdocslady.