Misleading - Mailing list pgsql-docs

From marek.cvoren@gmail.com
Subject Misleading
Date
Msg-id 20170328110253.2695.62609@wrigleys.postgresql.org
Whole thread Raw
Responses Re: Misleading  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List 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

pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: [DOCS] Consistent capitalization of procedural languages
Next
From: Peter Eisentraut
Date:
Subject: Re: Questionable tag usage