Message-ID: <9a545ec303e4c1a124c6b41b1b426b7c74cdb1c2.camel@cybertec.at>
Subject: Re: Improve "3.6. Inheritance" tutorial
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: =?ISO-8859-1?Q?Matem=E1tica?= A3K <matematica.a3k@gmail.com>
Cc: pgsql-docs@lists.postgresql.org
Date: Wed, 07 Oct 2026 23:00:29 +0200
In-Reply-To: 
 <CA+FDnh+3OSbze87OPnttj-A2R4oHM7_Yas=yS=MpgG82=qWixw@mail.gmail.com>
References: <179088091522.1026193.3570337969572056877@wrigleys.postgresql.org>
	 <3c6bdd69af16e90e3da20be277e836b25eeee1a5.camel@cybertec.at>
	 <CA+FDnhL0oygEJYZhDeAo+wwFykJeb__NNcO1+vyKSTqbTmQfvg@mail.gmail.com>
	 <344e5b7d87a8c0e8e8f5f4924345b1caec1a4418.camel@cybertec.at>
	 <CA+FDnh+3OSbze87OPnttj-A2R4oHM7_Yas=yS=MpgG82=qWixw@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
User-Agent: Evolution 3.60.2 (3.60.2-2.fc44) 
MIME-Version: 1.0
Archived-At: 
 <https://www.postgresql.org/message-id/9a545ec303e4c1a124c6b41b1b426b7c74cdb1c2.camel%40cybertec.at>
Precedence: bulk

On Wed, 2026-10-07 at 16:28 -0300, Matem=C3=A1tica A3K wrote:
> On Wed, Oct 7, 2026 at 11:43=E2=80=AFAM Laurenz Albe <laurenz.albe@cybert=
ec.at> wrote:
> > On Fri, 2026-10-02 at 12:23 -0300, Matem=C3=A1tica A3K wrote:
> >
> >=20
> > > The main technical concern is that querying is not explained on it, i=
t's
> > > explained on the "details page".
> > >=20
> > > More in concrete, if you add "In PostgreSQL, a table can inherit from=
 zero
> > > or more other tables, and a=C2=A0query can reference either all rows =
of a table
> > > or all rows of a table plus=C2=A0all of its descendant tables. The la=
tter behavior
> > > is the default." should be a "complete" explanation of the feature.
> >=20
> > I think the explanation in the tutorial is quite clear:
> >=20
> > =C2=A0 Here the ONLY before cities indicates that the query should be r=
un over
> > =C2=A0 only the cities table, and not tables below cities in the inheri=
tance
> > =C2=A0 hierarchy. Many of the commands that we have already discussed =
=E2=80=94 SELECT,
> > =C2=A0 UPDATE, and DELETE =E2=80=94 support this ONLY notation.
>=20
> Here, "quite clear" is the discrepancy.
>=20
> [...]
>
> My impression is that this happens *after* you read the full version, add=
ing that
> sentence to the summary would make it more clear for some users.

I personally am not convinced, but perhaps others agree with you.
Do you want to prepare a patch?

I think it would be best if we can avoid repeating the same information
in several places.  Such redundancy inflates the documentation and makes
it harder to find all places that have to be fixed when something changes.
Perhaps you can move things around to avoid that.

Yours,
Laurenz Albe