Re: Misleading "For more information..." placement

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: rsindlin(at)gmail(dot)com, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Misleading "For more information..." placement
Date: 2023-03-26 21:18:24
Message-ID: 70EC84A0-D958-4057-B9AA-C055605BF134@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 25 Mar 2023, at 16:43, PG Doc comments form <noreply(at)postgresql(dot)org> wrote:

> The final sentence ("For more information refer to Section 24.3") is easily
> read to refer to more information being available about character code zero
> (NUL). However, section 24.3 has no mention of NUL, but rather the
> available database character sets. I'd suggest moving that last sentence to
> immediately after the first sentence, which ends with "...when the database
> is created."

I think sentence with the link is better at the end, how about if we reword it
slightly to something like this to make it clearer?

"For more information on character sets refer to Section 24.3"

> A really minor point, but it caught me off-guard.

In Postgres we excel at caring about minor points, so thanks for your report!

--
Daniel Gustafsson

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Randall Sindlinger 2023-03-27 15:04:56 Re: Misleading "For more information..." placement
Previous Message Tom Lane 2023-03-25 16:53:35 Re: Split_Part w/negative integer does not work