The module scheme (`./module.rs` file + `./module` folder instead of just `./module/mod.rs`) introduced by the 2018 edition maybe a little bit (more) confusing

[RalfJung]

I agree that we should reword the docs here to not give a clear preference for either style. Clearly there's good arguments for both.

FWIW in VSCodium, the following helps a lot with mod.rs files (it fixes the "tab title" issue mentioned in the OP):

    "workbench.editor.customLabels.patterns": {
        "**/mod.rs": "${dirname}/mod.rs"
    },

@CAD97

I find that I use both styles, although I use mod.rs more often. Specifically, I use mod.rs for "structural" files that primarily consist of docs, mod and use, without defining any items themselves, and file.rs for files that directly contain a notable amount of code and might have a private helper module if needed.

That describes my style pretty well, too.

@CAD97

This means that if you write mod a { mod b { mod c; }} it will actually mount the source from ./a/b/c.rs.

I only recently discovered this and was quite surprised, too.