Re: Formatting of warning about using ident

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Formatting of warning about using ident
Date: 2019-07-01 11:48:52
Message-ID: D7DCADB0-D7E7-4C1B-ACFD-7C1AD466EFE5@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 26 Jun 2019, at 15:09, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> wrote:
>
> On 2019-06-14 10:47, Daniel Gustafsson wrote:
>> The warning about using ident for authorization or access control is using a
>> <blockquote> with an <attribution> rather than a <warning>, making it look
>> quite different from the rest of the manual, and less like a warning IMO.
>
> But this is a quote from the RFC. If you want to change it to a warning
> box, then you also need to rephrase the surrounding text. But I don't
> really see the need. It seems fine as it is.

It is indeed a quote, but to my reading/understanding the only reason we’ve
included it is to act as a warning? Thats why the formatting stood out as it’s
not consistent for warnings. The attached v2 instead wraps the quote in a
<warning> with a slight rewording to make it even more prominent.

cheers ./daniel

Attachment Content-Type Size
ident_warning-v2.patch application/octet-stream 1.8 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Jürgen Purtz 2019-07-02 08:13:37 TOC: List of Figures
Previous Message Daniel Gustafsson 2019-07-01 10:28:56 Re: Non working example