Re: Improve "3.6. Inheritance" tutorial

From: Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
To: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Improve "3.6. Inheritance" tutorial
Date: 2026-10-02 15:23:56
Message-ID: CA+FDnhL0oygEJYZhDeAo+wwFykJeb__NNcO1+vyKSTqbTmQfvg@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Fri, Oct 2, 2026 at 3:58 AM Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
wrote:

> On Thu, 2026-10-01 at 18:55 +0000, PG Doc comments form wrote:
> > Page: https://www.postgresql.org/docs/18/tutorial-inheritance.html
> >
> > I propose the following modifications: [...]
>
> Do I get you right that you don't have any problems with the
> technical content, but are unhappy about the style?
>

No, I'm unhappy with both, my suggestions go in both directions.

The main technical concern is that querying is not explained on it, it's
explained on the "details page".

More in concrete, if you add "In PostgreSQL, a table can inherit from zero
or more other tables, and a query can reference either all rows of a table
or all rows of a table plus all of its descendant tables. The latter
behavior is the default." should be a "complete" explanation of the feature.

> I think a tutorial is free to use sloppier language, but
> then that's just my opinion.
>

I understand

>
> Yours,
> Laurenz Albe
>

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Kacper Kuras 2026-10-03 18:43:15 Re: E.6.3.2.1. Constraints
Previous Message Matemática A3K 2026-10-02 15:12:44 Re: Improve "3.5. Window Functions" tutorial