3 ms·
Comments in configuration files that document the particular value of the setting ("why do we have this set this way") or other such subtleties make sense. Com
by JoshTriplett 11y ago
Comments in configuration files that document the particular value of the setting ("why do we have this set this way") or other such subtleties make sense. Comments in configuration files that document the setting itself definitely don't.
Unfortunately, many distributions ship configuration files in /etc with a pile of commented-out defaults and documentation, on the theory that doing so makes them easy to edit.
Personally, I prefer the current approach of not shipping a file in /etc at all, shipping the defaults in /usr if anywhere, and thus reducing the file in /etc to actual configuration.