[FM Discuss] FLOSS Manual for FSlint

Chris Stackpole c.stackpole at gmail.com
Mon Jun 21 16:39:22 PDT 2010


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Janet Swisher wrote:
> Use the second person instead of the third person. That is, say "you"
> instead of "the user" or "the reader". It's more personal and
> engaging. And it's perfectly OK in technical writing, in spite of
> anything your high school English teacher might have said. :-) It's
> also helpful in avoiding many uses of passive voice.


Thanks for the suggestion. There were definitely times in which I was
trying to distinguish between the reader and a generic computer user and
found it difficult. I have already updated those portions that I was
trying to make that separation and I am reading through it again to see
if there are other spots that would benefit from the change.

Thanks to everyone who has given me help and suggestions!

Chris Stackpole
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkwf+CoACgkQA8QwXn4S0qR1MACgrfqzOL+/JXTg4iAvxTKeE0hI
L3wAnRcok6mXT/WUjcwnZIUOVOzAZn4S
=SLOq
-----END PGP SIGNATURE-----



More information about the Discuss mailing list