Re: Improve "3.6. Inheritance" tutorial - Mailing list pgsql-docs

From Matemática A3K
Subject Re: Improve "3.6. Inheritance" tutorial
Date
Msg-id CA+FDnhL0oygEJYZhDeAo+wwFykJeb__NNcO1+vyKSTqbTmQfvg@mail.gmail.com
Whole thread
In response to Re: Improve "3.6. Inheritance" tutorial  (Laurenz Albe <laurenz.albe@cybertec.at>)
Responses Re: Improve "3.6. Inheritance" tutorial
List pgsql-docs


On Fri, Oct 2, 2026 at 3:58 AM Laurenz Albe <laurenz.albe@cybertec.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

pgsql-docs by date:

Previous
From: Matemática A3K
Date:
Subject: Re: Improve "3.5. Window Functions" tutorial
Next
From: Kacper Kuras
Date:
Subject: Re: E.6.3.2.1. Constraints