Documentation

[enaut]

Hello,

I'm currently trying to set up stalwart. The documentation is basically very good at explaining the options thank you for that! However, I'm missing which file I would add the config to. For example: https://stalw.art/docs/directory/types/sql#connection-string. Is this for the mail or the SMTP-backend?

Actually, I realized now that I have installed stalwart twice once only SMTP and once the full package. But still when having installed the full package there are many configuration files which one would be the opinionated best one for the configurations

[mdecimus]

Hi,

Settings can be added to any of the toml files since they are all merged at startup. However, if you would like to add or modify a directory, this should be done under etc/directory directory.

[enaut]

Thank you for your kind reply. I understood the configs way better now however I still think it would be helpful to have the default paths where the setting is placed somewhere on top of the docs or the code-display - most (all?) of the settings are already somewhere meaning if I add them in the wrong place they might get overwritten by the default. By having the "opinionated best place" in docs some of these errors might vanish.

Right now I just use grep on the config directory, which works.

[enaut]

I made a rough mockup of what I mean:

[mdecimus]

I agree, I'll add those details once the next version is released. Previously all settings were in a single file so the documentation needs to be updated.