#[2]​ has a conf generator website? My experience with hard coded conf files is users run with settings they don't understand.

Reply to this note

Please Login to reply.

Discussion

That's not an argument against having the comments explaining the meaning of each variable.

It's debatable whether it's an argument against doing what e.g. Tor does and have all the useful variables *there*, with defaults, and commented out where appropriate.

The main thing is the documentation. I would be fine with just having it in external documentation.

In particular it doesn't make sense to put the generation function in an area only realistically accessible to developers, when non-dev users need this (in a sense that's the whole point of config files - to translate functionality manipulation into a form that non-developers can use).