Re: BUG #13589: content error - Mailing list pgsql-bugs

From Tom Lane
Subject Re: BUG #13589: content error
Date
Msg-id 22071.1440541194@sss.pgh.pa.us
Whole thread Raw
In response to Re: BUG #13589: content error  (Andres Freund <andres@anarazel.de>)
Responses Re: BUG #13589: content error  (Alvaro Herrera <alvherre@2ndquadrant.com>)
Re: BUG #13589: content error  (Andres Freund <andres@anarazel.de>)
Re: BUG #13589: content error  (Thomas Munro <thomas.munro@enterprisedb.com>)
List pgsql-bugs
Andres Freund <andres@anarazel.de> writes:
> On 2015-08-25 20:37:43 +0000, barnettluisa@gmail.com wrote:
>> "Possibly, your site administrator has already created a database for your
>> use. He should have told you what the name of your database is. In that case
>> you can omit this step and skip ahead to the next section."

> Maybe: "Possibly, your site administrator has already created a database
> for your use, in which case you should already have been told what the
> name of your database. ..."?

The hard part of getting rid of "he" is to not make the text harder to
read (you failed at that) or be distracting about it.  We're trying to
write technical documentation, not to be politically correct.  (Being
PC is fine, mind you, I just don't want to be in-your-face about it.)

I don't mean to dismiss the idea, but I think fixing this without doing
damage to other worthy goals is going to be a lot harder than just
"s/he/he or she/g".

As mentioned upthread, constructive criticism in the form of a patch
might serve to move the discussion forward.

            regards, tom lane

PS: in this *particular* example, I wonder whether we couldn't dodge the
problem by just omitting the second sentence altogether.

pgsql-bugs by date:

Previous
From: Andres Freund
Date:
Subject: Re: BUG #13589: content error
Next
From: John R Pierce
Date:
Subject: Re: BUG #13589: content error