Re: [boost] Gender neutral documentation

From: David Cameron (dave.bc_at_[hidden])
Date: 2005-11-04 12:55:30

> Returning to the original example:
>     This means for example that the client can completely
>     discard Bind if she does not need it.
> I'd suggest rewriting it as:
>     This means that the user can discard Bind completely
>     if it is not needed.

This is so much better than using "they." "They" works well in casual
conversation, but in documentation I always eventually find myself
looking for the plural group it's referring to. The boost maintainers?
The user community? My user community? Documentation is difficult
enough to read without introducing confusion by substituting pronouns
non-grammatically.

--
David Cameron
University of British Columbia
http://bar.psych.ubc.ca/People/Dave.html