Re: Change JOIN tutorial to focus more on explicit joins

From: Thomas Munro <thomas(dot)munro(at)gmail(dot)com>
To: shammat(at)gmx(dot)net, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Change JOIN tutorial to focus more on explicit joins
Date: 2020-05-20 21:56:02
Message-ID: CA+hUKG+K+75fo+cKA2Vb_kmFsxX=9qgi48_dLqPyShfhFdSKMw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Thu, May 21, 2020 at 1:37 AM PG Doc comments form
<noreply(at)postgresql(dot)org> wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/12/tutorial-join.html
> Description:
>
> The tutorial about joins makes the following statement about the explicit
> JOIN operator:
>
> > This syntax is not as commonly used as the one above
>
> I think in 2020 this claim is no longer true, and I would love to see the
> manual prefer the "modern" explicit JOIN operator rather than sticking to
> the ancient implicit joins in the WHERE clause.

+1

The "new" syntax is 28 years old, from SQL 92. I don't see too many
SQL 86 joins. Would you like to write a documentation patch?

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-05-21 09:03:23 Problem
Previous Message Tom Lane 2020-05-20 19:53:23 Re: descriptions of pg_stat_user_functions and pg_stat_slru

Browse pgsql-hackers by date

  From Date Subject
Next Message Jonathan S. Katz 2020-05-20 22:11:08 Re: PostgreSQL 13 Beta 1 Release Announcement Draft
Previous Message Alvaro Herrera 2020-05-20 21:54:18 Re: factorial function/phase out postfix operators?