Minor improvement in sentences to enhance readability

From: Muhammad Ikram <mmikram(at)gmail(dot)com>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Minor improvement in sentences to enhance readability
Date: 2024-06-13 08:34:46
Message-ID: CAGeimVoKM6YoEEX2hMQG2PcBXA4DYGxqJow8aM8dDsSADKC8=w@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Here are some minor change suggestions which may help in improving
readability.
It is your prerogative to accept or reject

Doc : https://www.postgresql.org/docs/17/install-make.html

*Actual Text*

If you are upgrading an existing system be sure to read Section 18.6
<https://www.postgresql.org/docs/17/upgrading.html>, which has instructions
about upgrading a cluster.

*Proposed*
If you are upgrading an existing system, be sure to read Section 18.6
<https://www.postgresql.org/docs/17/upgrading.html>, which has instructions
about upgrading a cluster.

Hi,

Suggesting minor improvements in
https://www.postgresql.org/docs/17/install-make.html
to enhance readability.

*Change*
Added comma between "system and be"
--

To keep the text consistent, built might be replaced by build.

*Actual Text*

If you *built* with debugging support, stripping will effectively remove
the debugging support

*Proposed*

If you *build* with debugging support, stripping will effectively remove
the debugging support

*Change*
Replaced built by build

*Actual Text*
All files will be installed under /usr/local/pgsql by default.

*Proposed*
By default, all files will be installed under /usr/local/pgsql.

*Actual Text*

(Remember to use GNU make.) The build will take a few minutes depending on
your hardware.
*Proposed*
The build will take a few minutes, depending on your hardware (remember to
use GNU make).

*Actual Text*

use ./configure --help to get one that is

*Proposed*

use ./configure --help to see all options.

or

use ./configure --help to list all options.

Regards,
Muhammad Ikram,
Bitnine Global

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2024-06-13 08:59:18 8.12. UUID Type
Previous Message Will Mortensen 2024-06-12 01:20:42 Re: Documenting more pitfalls of non-default collations?