"Shipping" requires a lot of work, and some people just refuse to do that. Some of my popular programs are just repos on Github. To use them you have to run build script and execute from source code.
It elimites people who would require a lot of support, and would not give a meaningful contribution. Less work for me...
And if you desperately need my software, I always provide consulting...
I make a habit of providing these for myself and they are great, both when I enter a new domain and need to remind myself of best practice, and when I return to a domain after a long time.
The lack of such instructions is a strong indicator to me that a project hasn’t reached maturity.
That said, it unfortunately doesn't go on to specify local-user overridability via $XDG_CONFIG_HOME etc, which might limit its adoption.
Synapse also supports using a drop-in directory for configuration
At least if the maintainers version and your version require review, you have a fighting chance to update the configuration with your customizations, without downtime or unexpected behavior.
If you want to avoid downtimes, you need to read changelogs and plan upgrades, and maybe test the upgrades before upgrading the production, in any case.
But you have a point, and maybe a solution to this issue ought to be found.
I can't agree more with this.
Please make me edit completely empty files to override defaults.
Also related, it's painful when APT asks you what to do with an upgraded configuration file, just to notice that upstream edits are just mistake fixes in comments (hello Matrix / Synapse a while ago), or that self-closing XML tags have became totally equivalent but more verbose full, empty tags (WHY?!? Hello Collabora Online).
The moves to:
- let us expand the configuration in config.d folders
- ship default configuration files in system folders, outside /etc, config that you can overrides in /etc
are welcome. With the later, you can provide a fully documented default config file, and then I can override it, even commenting why I changed a value and these comments are not mixed with upstream documentation.