On Wed, 2026-10-07 at 16:28 -0300, Matemática A3K wrote:
> On Wed, Oct 7, 2026 at 11:43 AM Laurenz Albe <laurenz.albe@cybertec.at> wrote:
> > On Fri, 2026-10-02 at 12:23 -0300, Matemática A3K wrote:
> >
> >
> > > 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 the explanation in the tutorial is quite clear:
> >
> > Here the ONLY before cities indicates that the query should be run over
> > only the cities table, and not tables below cities in the inheritance
> > hierarchy. Many of the commands that we have already discussed — SELECT,
> > UPDATE, and DELETE — support this ONLY notation.
>
> Here, "quite clear" is the discrepancy.
>
> [...]
>
> My impression is that this happens *after* you read the full version, adding 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
