Date: Mon, 5 Jul 2021 10:30:23 -0400
From: Stephen Frost <sfrost@snowman.net>
To: Bruce Momjian <bruce@momjian.us>
Cc: "Daniel Westermann (DWE)" <daniel.westermann@dbi-services.com>,
	Euler Taveira <euler@eulerto.com>,
	"pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Subject: Re: Link missing in the 14 release notes
Message-ID: <20210705143023.GZ20766@tamriel.snowman.net>
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>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="pLZ5/pN6fBAg6el4"
Content-Disposition: inline
In-Reply-To: <20210702173647.GB25522@momjian.us>
User-Agent: Mutt/1.5.24 (2015-08-30)
Archived-At: 
 <https://www.postgresql.org/message-id/20210705143023.GZ20766%40tamriel.snowman.net>
Precedence: bulk


--pLZ5/pN6fBAg6el4
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Greetings,

* Bruce Momjian (bruce@momjian.us) wrote:
> On Fri, Jul  2, 2021 at 05:15:23AM +0000, Daniel Westermann (DWE) wrote:
> > >On Thu, Jul=A0 1, 2021 at 10:01:46PM -0400, Stephen Frost wrote:
> > >Only the first mention of "factorial()" uses a link;=A0 the second item
> > >doesn't have any link.
> >=20
> > There are other places as well, like this on:
> > "The postgres_fdw supports these type of scans if async_capable is set."
> >=20
> > async_capable is not a link. Or this one:
> > "This speeds normalize() and IS NORMALIZED."=20
> >=20
> > I still think it should be more consistent and all should be links, eve=
n if they point to the same section.
>=20
> 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

--pLZ5/pN6fBAg6el4
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCgAGBQJg4xd/AAoJEO1sijiDR2RVj0AP/iZ8E8ZkKZDk6vWq85SNzTMd
azwK6cYbCwMuVql9qJS17aF2n18ZE7KEbx4dunhxeT2TnDlqAoDTiEBo/EgYxgkw
HZgYA2PNYO2ipxDkiqU5wAEQCiPH2cgKnDfWu45gu2ZKfxUgT0Ui5uWL3+ym7fC4
7SnxEcdlTEKxZHLPb4XqqFgamO44EIUAmnGUkGuyX6/PPaoQj1PLztqcpYghw7j9
v9VrPEEbeRrIPEM5jtRi1jgqAmuI+esaKAPimCO7G6GvgtxBbkC0jeeTIfyVoOEG
5SR+fLjw8v6HNd5JHeaRhsqJChZpVPO3B9iQOLqZ7qm+/svQHz2SCqe9g2+D5Bnx
oOkXS91BFHjz1MT7MwisG2F+RnnmlhxucvXdLF1M5eJ6IWcgccVR06KeKwJP2Git
EK7AD+WcQLbWohns8N0hWs8qXoWquZN62P3E12gzEBkmi/vMaUGjJ9U69g5y5GCj
0YKi3OqX/+KSoXyc2F7cJW3X36uUyrGMcXjtZkpgrqqnRvkZlB35MefmY7JLEMt1
hKts6lk1+t9s7cRpbjq1zIksjznuMxe348k7QAcip6kOKsrQQaUVex0djWLIDy4h
cdrQVQlodDmX7rZu1Eg4J8C6oYpt7HeAosaeuogNdgFFIz+p1vCgZdWQKqmqnC8h
763Gj9gL8nqnoZ21PInR
=ePst
-----END PGP SIGNATURE-----

--pLZ5/pN6fBAg6el4--