From: Daniel Gustafsson <daniel@yesql.se>
To: Heikki Linnakangas <hlinnaka@iki.fi>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: Consistent reference to RFCs in the documentation
Date: Tue, 1 Dec 2020 13:55:27 +0100
Message-ID: <2C7F4A07-49AA-4FAD-A152-EB9DAD07D211@yesql.se> (raw)
In-Reply-To: <a06ea0f1-8aa0-3cee-0587-f895387cda12@iki.fi>
References: <2C697878-4D01-4F06-8312-2FEDE931E973@yesql.se>
<a06ea0f1-8aa0-3cee-0587-f895387cda12@iki.fi>
> On 1 Dec 2020, at 13:39, Heikki Linnakangas <hlinnaka@iki.fi> wrote:
> On 05/11/2020 17:09, Daniel Gustafsson wrote:
>> The attached patch adds ulinks for all
>> RFC's and marks subsequent mentions as acronym to make the docs consistent. It
>> also spells all as "RFC <number>" with a whitespace as that was the most
>> commonly used spelling (there is no RFC for how to reference to an RFC so we're
>> free to choose).
>
> There is RFC 7322, "RFC Style Guide", Section 3.5 Citations (https://tools.ietf.org/html/rfc7322#section-3.5). That's for the style used in RFCs themselves. It recommends "RFC <number>" as well.
Interesting, I've looked for that more than once but failed to find that
section. Thanks for pointing it out.
> Pushed, thanks!
Thanks!
cheers ./daenil
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: daniel@yesql.se, hlinnaka@iki.fi, pgsql-docs@lists.postgresql.org
Subject: Re: Consistent reference to RFCs in the documentation
In-Reply-To: <2C7F4A07-49AA-4FAD-A152-EB9DAD07D211@yesql.se>
* 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