| From: | Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz> |
|---|---|
| To: | Geoff Winkless <pgsqladmin(at)geoff(dot)dj> |
| Cc: | Albe Laurenz <laurenz(dot)albe(at)wien(dot)gv(dot)at>, Peter Geoghegan *EXTERN* <pg(at)heroku(dot)com>, Erik Rijkers <er(at)xs4all(dot)nl>, Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-committers <pgsql-committers(at)postgresql(dot)org>, "pgsql-committers-owner(at)postgresql(dot)org" <pgsql-committers-owner(at)postgresql(dot)org>, Pg Hackers <pgsql-hackers(at)postgresql(dot)org> |
| Subject: | Re: [HACKERS] pgsql: Use gender-neutral language in documentation |
| Date: | 2015-09-24 10:33:43 |
| Message-ID: | 5603D187.8010301@archidevsys.co.nz |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-committers pgsql-hackers |
An example from a book on PostgreSQL server programming that I'm working
through (Note that it is obviously awkward to write with gender pronouns
when gender is irrelevant, note the "he she" in one place and "he/she"
in another!):
"If the user is a superuser, then he she has permission to see the
full query. If the user is a regular user, he/she will only see the
full query for his/her queries."
Written in 'Gender Appropriate' style (only refer to gender when it is
relevant):
"If the user is a superuser, then they have permission to see the
full query. If the user is a regular user, they will only see the
full query for their queries."
I think the second version is easier to read - and in this case, shorter!
-Gavin
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Geoff Winkless | 2015-09-24 10:41:07 | Re: [COMMITTERS] pgsql: Use gender-neutral language in documentation |
| Previous Message | Tom Lane | 2015-09-23 22:27:30 | pgsql: Make ANALYZE compute basic statistics even for types with no "=" |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Geoff Winkless | 2015-09-24 10:41:07 | Re: [COMMITTERS] pgsql: Use gender-neutral language in documentation |
| Previous Message | Tomas Vondra | 2015-09-24 09:50:09 | Re: DBT-3 with SF=20 got failed |