Re: Link missing in the 14 release notes

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: "Daniel Westermann (DWE)" <daniel(dot)westermann(at)dbi-services(dot)com>
Cc: Stephen Frost <sfrost(at)snowman(dot)net>, Euler Taveira <euler(at)eulerto(dot)com>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Link missing in the 14 release notes
Date: 2021-07-02 17:36:47
Message-ID: 20210702173647.GB25522@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

If only the physical world exists, free will is an illusion.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2021-07-02 19:11:15 docs issue in transactions section
Previous Message Euler Taveira 2021-07-02 14:47:09 Re: Link missing in the 14 release notes