Marcos Pegoraro писал(а) 2025-02-06 04:07:
Reading DOCs sometimes is boring because you want to know only the
default value of something. I know what that GUC is, I know how to
change it, I only don't remember what its default value is. Then you
have to read that entire paragraph just to read tha
On Thu, Feb 6, 2025 at 10:46 PM Marcos Pegoraro wrote:
>
> I agree that duplicating default values is not fine, I can remove them from
> the explanation and put it only near definition.
>
> But about adding a new line with its default value, sometimes is fine,
> sometimes not.
> [1] is a good ex
Em qui., 6 de fev. de 2025 às 12:32, Greg Sabino Mullane
escreveu:
> That seems a somewhat arbitrary goal for us to optimize for.
>
well, my goal was to standardize these values. As examples of
non standardization you have ...
"The default is typically 100 connections".
Tipically ? Is it 100 or
On Thu, Feb 6, 2025 at 4:46 AM Marcos Pegoraro wrote:
> Objective here is to those ones who know what it is, but don't
> remember its default.
>
My approach would be to add a summary table (or tables) in the first
subsection of each major X.Y (section X.Y.1) that lists the name, brief
descriptio
On Thu, Feb 6, 2025 at 6:46 AM Marcos Pegoraro wrote:
> And obviously, if you don't know the purpose of that GUC, you'll have to
> read the entire paragraph to understand it.
> Objective here is to those ones who know what it is, but don't
> remember its default.
>
That seems a somewhat arbitrar
I agree that duplicating default values is not fine, I can remove them from
the explanation and put it only near definition.
But about adding a new line with its default value, sometimes is fine,
sometimes not.
[1] is a good example which would be fine but the next
ones cpu_tuple_cost, cpu_index_t
On Thu, Feb 6, 2025 at 8:08 AM Marcos Pegoraro wrote:
>
> Reading DOCs sometimes is boring because you want to know only the default
> value of something. I know what that GUC is, I know how to change it, I only
> don't remember what its default value is. Then you have to read that entire
> par
