| 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
>
| 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 |