Re: Section 4.1.2.3 repeats information presented in section 4.1.1 - Mailing list pgsql-docs

From Tom Lane
Subject Re: Section 4.1.2.3 repeats information presented in section 4.1.1
Date
Msg-id 2445458.1702398326@sss.pgh.pa.us
Whole thread Raw
In response to Section 4.1.2.3 repeats information presented in section 4.1.1  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
PG Doc comments form <noreply@postgresql.org> writes:
> The following documentation comment has been logged on the website:
> Page: https://www.postgresql.org/docs/16/sql-syntax-lexical.html
> Description:

> it just threw me off to read the exact same thing twice in quick succession,
> I'd suggest linking to section 4.1.2.3 in section 4.1.1 instead.

They are *not* the same.  The quoting is different and the
meaning is quite different, just as "slon" and 'slon' are
not equivalent in SQL.  Moreover, there's little reason to
assume that somebody coming to 4.1.2.3 necessarily just
read 4.1.1.

Perhaps it'd be better to use different example strings though?

            regards, tom lane



pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Section 4.1.2.3 repeats information presented in section 4.1.1
Next
From: PG Doc comments form
Date:
Subject: 'bar' shouldn't be a string in example