From: Stephen Frost <sfrost@snowman.net>
To: Bruce Momjian <bruce@momjian.us>
Cc: Daniel Westermann (DWE) <daniel.westermann@dbi-services.com>
Cc: Euler Taveira <euler@eulerto.com>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: Link missing in the 14 release notes
Date: Mon, 5 Jul 2021 10:30:23 -0400
Message-ID: <20210705143023.GZ20766@tamriel.snowman.net> (raw)
In-Reply-To: <20210702173647.GB25522@momjian.us>
References: <ZR0P278MB0409732B8E841EFD031C5E97D2019@ZR0P278MB0409.CHEP278.PROD.OUTLOOK.COM>
<d2acc67d-7095-4960-9e21-537a6bea58bb@www.fastmail.com>
<20210701214616.GT20766@tamriel.snowman.net>
<20210702013517.GF3618@momjian.us>
<CAOuzzgqLRbvw7UsT3e7GnpKeWiQVNkLFo8vbLBQ+aJWMv+RYgA@mail.gmail.com>
<20210702015726.GG3618@momjian.us>
<CAOuzzgpfGt6skZUALhuav0J7qy5Em+X_4in3gS2_WRDA125zzg@mail.gmail.com>
<20210702023011.GA6730@momjian.us>
<ZR0P278MB04093B008E3D2247547B518BD21F9@ZR0P278MB0409.CHEP278.PROD.OUTLOOK.COM>
<20210702173647.GB25522@momjian.us>
Greetings,
* Bruce Momjian (bruce@momjian.us) wrote:
> On Fri, Jul 2, 2021 at 05:15:23AM +0000, Daniel Westermann (DWE) wrote:
> > >On Thu, Jul 1, 2021 at 10:01:46PM -0400, Stephen Frost wrote:
> > >Only the first mention of "factorial()" uses a link; the second item
> > >doesn't have any link.
> >
> > There are other places as well, like this on:
> > "The postgres_fdw supports these type of scans if async_capable is set."
> >
> > async_capable is not a link. Or this one:
> > "This speeds normalize() and IS NORMALIZED."
> >
> > I still think it should be more consistent and all should be links, even if they point to the same section.
>
> I am using standard typographic style, where the first mention of
> something is often italics, but later mentions might not be. I am not
> in favor of adding links to everthing that can have a link _unless_
> there is a unique URI for each item.
While I understand that's the approach you've been following, I don't
agree with it. Providing links gives users a way to find more
information and that applies to each equally. I don't believe users of
the website and release notes would be confused, upset, or otherwise
misunderstand when two items which are covered in the same place have a
repeated link for each of the items.
Thanks,
Stephen
Attachments:
[application/pgp-signature] signature.asc (818B, ../20210705143023.GZ20766@tamriel.snowman.net/2-signature.asc)
download
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: sfrost@snowman.net, bruce@momjian.us, daniel.westermann@dbi-services.com, euler@eulerto.com, pgsql-docs@lists.postgresql.org
Subject: Re: Link missing in the 14 release notes
In-Reply-To: <20210705143023.GZ20766@tamriel.snowman.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox