TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: Use of "You" From:"Brierley, Sean" <Sean -at- Quodata -dot- Com> To:TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 29 Nov 1999 10:48:03 -0500
Hallo:
Tell the instructors that, while you understand they mean well and really
believe they know what they teach, they've been in academia too long and
have lost touch with the industry.
The implied 'you' only goes so far. The word 'you' has to show up. 'One' and
'the user' are stilted.
The thread you started might be more appropriate than the he/she thing
because you are addressing the state of the profession: academia versus real
world, is there a difference. I suppose, that's one of my beefs with the STC
<g>.
Anyway, does one go into teaching with no real-world experience as a tech
writer and, if not, how does one maintain one's skills after one leaves the
tw workforce to become sequestered as an instructor. I suppose, all this
begs the question: are the instructors writers or other professionals, such
as programmers or engineers, by training?
<see?>
Thanks, Joanne, IMHO, a good question.
Sean
sean -at- quodata -dot- com
-----Original Message-----
From: Joanne Meehl [SMTP:Jmeehl -at- datum -dot- com]
Two of the instructors in my Tech Writing program at Northeastern
Univ. say
"NEVER use 'you' in technical documentation".
They don't mean the writer
should eliminate the implied "you", as in "Click the right mouse
button".
They just don't like the sound of "you"--they say it's too casual or
familiar.
But some of you are saying it works. What's a newbie like me to do?!
I
don't want to start a thread like "he/she", so please respond
privately,
particularly those of you who've had to make this decision and
choose
between "you" and phrases like "the user". I want to do what's right
without
doing flavor-of-the-month.