| From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
|---|---|
| To: | Joshua Drake <jd(at)commandprompt(dot)com> |
| Cc: | pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
| Subject: | Re: Cleanup of syntax.sgml |
| Date: | 2025-06-20 21:37:23 |
| Message-ID: | CAKFQuwbbsk9BSs_7+C3mvrROBrBASkMwOZXEkbppoapJHKeDGw@mail.gmail.com |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
On Fri, Jun 20, 2025 at 2:21 PM Joshua Drake <jd(at)commandprompt(dot)com> wrote:
>
>
>> "We advise users who to read this chapter carefully ..." ? botched
>> surgery on this one
>>
>
> Not sure what you mean here? I reviewed the source sgml (that I modified):
>
> We advise users who to read this chapter carefully because it
> contains several rules and concepts that are implemented
> inconsistently among SQL databases or that are specific to
> <productname>PostgreSQL</productname>.
>
> We advise users who to read this chapter carefully... is not proper
English - drop the "who"?
We advise users to read this chapter carefully
Honestly, though, that is just bad advice. It is not possible to read it
carefully, it's too much material. Apply ruthless subjective-ness removal
protocol here too. Just state what the chapter covers.
David J.
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Masahiko Sawada | 2025-06-21 00:55:15 | Re: Fix incorrect UUID index entry in function documentation |
| Previous Message | Joshua Drake | 2025-06-20 21:21:36 | Re: Cleanup of syntax.sgml |