Consistent reference to RFCs in the documentation

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Consistent reference to RFCs in the documentation
Date: 2020-11-05 15:09:48
Views: Raw Message | Whole Thread | Download mbox | Resend email
Lists: pgsql-docs

When referencing RFC's, we have a mix of ulinking to the entry and
not. Also, for subsequent mentions of the same RFC on the same page we have
some as <acronym> while others are not. 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).

In order to make review easier I haven't fixed linelengths/wrapping, but am
happy to do that in case this is deemed something we want.

cheers ./daniel

Attachment Content-Type Size
0001-docs-ulink-all-references-to-RFC-s.patch application/octet-stream 14.2 KB


Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-11-05 19:45:43 Possible Example Error in Documentation
Previous Message Magnus Hagander 2020-11-04 13:09:27 Re: On what system does the postgresql docs run?