Message-ID: <87f00359-a8d6-4e0b-9cd8-78084ec89033@proxel.se>
Date: Fri, 3 Apr 2026 21:50:30 +0200
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: Docs: Distinguish table and index storage parameters in CREATE
 TABLE
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
References: 
 <CAKFQuwYe1vf7k+gx_f5ny1mpz_CrhMhaa_NgVb-87_=DHj3JEw@mail.gmail.com>
 <e7286453-7d8c-460d-b6fa-95df54c3ca13@proxel.se>
 <f828ab0a-0231-4673-a407-e550cdc549bd@proxel.se>
 <CAKFQuwYMbsUQ65CYsyVxKrcqa2BmvRmBh6bAuXocoMEp3sZwGg@mail.gmail.com>
From: Andreas Karlsson <andreas@proxel.se>
Content-Language: en-US
In-Reply-To: 
 <CAKFQuwYMbsUQ65CYsyVxKrcqa2BmvRmBh6bAuXocoMEp3sZwGg@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
Archived-At: 
 <https://www.postgresql.org/message-id/87f00359-a8d6-4e0b-9cd8-78084ec89033%40proxel.se>
Precedence: bulk

On 4/3/26 9:44 PM, David G. Johnston wrote:
> I'm not opposed to it but figured I'd wait for a committer to show 
> interest and ask the scope to be expanded to a full docs review instead 
> of just addressing the immediate user-reported confusion.  When I do 
> expand the scope on my own it seems to scare them off.

Well, ALTER TABLE also has the same potential confusion so I think we 
should either just change CREATE TABLE and ALTER TABLE or all of CREATE 
TABLE, ALTER TABLE, CREATE INDEX and ALTER INDEX.

Just changing the two CREATE pages makes little sense when CREATE|ALTER 
TABLE are both equally problematic en my opinion.

Andreas