Re: Consistent reference to RFCs in the documentation

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Heikki Linnakangas <hlinnaka(at)iki(dot)fi>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Consistent reference to RFCs in the documentation
Date: 2020-12-02 19:21:42
Message-ID: 20201202192142.GA20285@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Tue, Dec 1, 2020 at 02:39:04PM +0200, Heikki Linnakangas wrote:
> On 05/11/2020 17:09, Daniel Gustafsson wrote:
> > When referencing RFC's, we have a mix of ulinking to the ietf.org entry and
> > not. Also, for subsequent mentions of the same RFC on the same page we have
> > some as <acronym> while others are not.
>
> I'm not sure how sensible the <acronym> tag is for these. I mean, yeah, it's
> an acronym, but it wouldn't make sense to write it open. It doesn't seem to
> affect the formatting in the HTML docs, at least I don't see any difference
> in my browser. But let's be consistent.

Ideally acronyms would use smallcaps, but I don't think we have that
configured in our style sheets.

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

The usefulness of a cup is in its emptiness, Bruce Lee

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-12-02 20:21:27 The sub-categories do not have anchors on this page
Previous Message Daniel Gustafsson 2020-12-01 12:55:27 Re: Consistent reference to RFCs in the documentation