On Sun 2022-04-10 18:03:13 +0200, Guillem Jover wrote: > Also true in principle, as long as the man page is coming from upstream > (and gets updated by them or a script :) or gets generated from the > Debian packaging out of --help output, which I'm not sure is the case > for all current exporters. But DRY principle and all.
Agreed. But if the package maintainer has to spend any time at all
keeping some documentation up to date, please spend it ensuring that the
manpage is up-to-date, as that's going to be relevant for many more
people than /etc/default/prometheus-node-exporter.
> I can bring it up on the team's IRC channel, and gather the feeling of
> the team about this.
Thanks! One other motivating reason to simplify the file is that it's
easy for a busy/rushed admin to scan the file, see the long list of
commented options and think "i'll just uncomment the ones that i want"
(without understanding that they need to be copied to the ARGS="" line).
Less text makes it easier for someone in a rush to focus on the most
important thing, which is where the options go.
Thanks for looking into this, Guillem!
--dkg
signature.asc
Description: PGP signature
