multisite-setup, setup.php `plugins` key does not allow disabling plugins

[drzraf]

https://github.com/getgrav/grav-learn/blob/develop/pages/08.advanced/05.multisite-setup/docs.17.md indicates that user/setup.php could do something like:

return [
    'plugins' => []
];

I tried:

return [
    'plugins' => [
        'problems' => [
            'enabled' => 'false'
        ],
        'git-sync' => [
            'enabled' => 'false'
        ]
    ],

... in order to disable a set of plugins, without success.

Whether or not this is supported, this must be documented. Note: I couldn't find the necessary codebase references to dig for the underlying logic.

[mahagr]

Setup is not meant to do that. It just initializes the system so that everything loads from the right place -- including the configuration. Configuration files that get loaded later will override everything in the setup.

[drzraf]

Yeah, but it's documented it could already do that (= configure plugins):

So one would expect it could disable plugins too.

[mahagr]

No, even that won't work if you override the keys. Besides above example has been superseded with a better solution anyways.

[drzraf]

Could you please remove that misleading chunk from the documentation and put the better solution? I'm interested knowing what best practices are advised.