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
-- David Cameron University of British Columbia http://bar.psych.ubc.ca/People/Dave.html
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk