Misleading

From: marek(dot)cvoren(at)gmail(dot)com
To: pgsql-docs(at)postgresql(dot)org
Subject: Misleading
Date: 2017-03-28 11:02:53
Message-ID: 20170328110253.2695.62609@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.6/static/pgupgrade.html
Description:

Hello,

Please correct following part of pg_upgrade documentation:
`You can also specify user and port values, and whether you want the data
linked instead of copied (the default).`

It is not clear what is the default option. If you read the whole sentence,
then context might be misinterpreted to `data linked instead of copied` is
default but you meant that copying is default. Please correct this as it is
confusing and can lead someone to big troubles.

My suggestion:
- completely omit confusing default word:
`You can also specify user and port values, and whether you want the data
linked instead of copied.`

Thank you.

Cheers,
Marek

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2017-04-03 14:52:52 Re: [HACKERS] Questionable tag usage
Previous Message Daniel Gustafsson 2017-03-24 09:44:15 Consistent capitalization of procedural languages