Re: GNOME Documentation Style Guide

[eliot landrum <eliot landrum cx>]

This has always been a source of frustration for me for many years. I 
dug out my /Elements of Style/ by Strunk and White and searched through 
it for something definitive in this matter. Unfortunatly, I found 
nothing. I guess they never thought much about technical writing. Does 
anyone have a more recent version than my 1979 edition?

Perhaps we should just make characters up like many cryptography 
documentation authors have been doing. Then we can make our docs like a 
novel. ;)

I really should read /Elements of Style/ all the way through. It is a 
gold mine!

I suppose I really had nothing good to contribute to this conversation. 
*shrug*

Dave Mason wrote:

> On 03 Jul 2001 08:43:27 -0400, Kevin Breit wrote:
>
>
> > A few years ago in English class (yes...this is in the high schools, so
> > remember its quite sterile!) my teacher told us that we should use he
> > over she.  This is because gramatically, the he encompasses both males
> > and females, while she is specific to females.
> > Comments?
> > Kevin Breit
>
> English teachers say many things - many of which conflict with each
> other.
>
> I have always thought that mixing it up is a good idea. So I can talk
> about he in one sentence, and she in the next. I doesn't make the reader
> stumble over the he/she (s)he weirdness. Is it 100% correct - I suppose
> it depends on who you ask - but I have always thought it was a good
> compromise.
>
> Cheers,
>
> Dave
>
>
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list


--
Eliot Landrum
eliot landrum cx
GnuPG ID: 8F5B499E

-Soli Deo Gloria-