Is it wise to include table inheritence in the tutorial?

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: martin(at)arp242(dot)net
Subject: Is it wise to include table inheritence in the tutorial?
Date: 2019-08-04 22:14:24
Message-ID: 156495686451.8638.382610819642178810@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/11/tutorial-inheritance.html
Description:

Hello,

I was reading the tutorial here:
https://www.postgresql.org/docs/11/tutorial-inheritance.html

But on the "don't do this" Wiki, it is strongly advised not to use this:
https://wiki.postgresql.org/wiki/Don't_Do_This#Don.27t_use_table_inheritance

It seems to me that there should at least be a warning, or the entire
section could possible be removed? The tutorial is intended for people new
to PostgreSQL and/or SQL, and introducing features with a large "don't use
this caveat" doesn't strike me as especially helpful?

Cheers,
Martin

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2019-08-05 14:17:40 Re: Is it wise to include table inheritence in the tutorial?
Previous Message Joe Conway 2019-08-01 18:48:30 Re: SET ROLE documentation not entirely correct