On Tue, Jan 14, 2025 at 11:45 AM Nathan Bossart <nathandboss...@gmail.com> wrote: > > On Tue, Jan 14, 2025 at 11:08:36AM -0600, Sami Imseih wrote: > > After staring at the documentation for a while, I am now > > wondering whether we are adequately describing the > > rationale for this GUC. The GUC documentation mentions that this is a > > 'cap on the value calculated with autovacuum_vacuum_threshold > > and autovacuum_vacuum_scale_factor,' which is acceptable; > > however, I think further elaboration is necessary in > > routine-vacuuming.html#AUTOVACUUM. This is because > > scale_factor and threshold are already well-known > > and widely understood parameters, and introducing > > a third one to the mix deserves a bit more of an > > explanation. What do you think? > > I think it would be odd to explain the intent for one autovacuum parameter > while leaving the others unexplained. IMHO it would be better to address > this for all such parameters in a follow-up patch.
absolutely, the documentation will need to discuss the relationship between all 3 parameters for the documentation to make sense. Regards, Sami
