ProZ.com global directory of translation services
 The translation workplace
Ideas

 
Pages in topic:   < [1 2]
User
Thread poster: Michael Harris
Technical manuals - The use of "you"

straygoat
United Kingdom
English
'you' is fine Jan 12

Hi Michael,

I'm a technical author and I can assure you that using 'you' is fine and I believe it is included in the Microsoft guide on documentation standards. Keeping the copy impersonal is decidedly 'old school' and can cause problems, particularly in countries where people are likely to sue at the drop of a hat (i.e. America).

The use of 'you' makes it absolutely explicit who is performing the action described, and that's the best argument for including it. It eliminates ambiguity.

I work for a major international company and the use of 'you' is required as part of their quality policy. The documentation is used in countries all over the world and it is for a highly technical engineering product. There is no benefit to not using 'you' other than it makes a company appear more corporate.

Some people just think documentation has to be very formal and be almost academic in style...that's just bad practice in my view. The easier the documentation is to read and understand, the more effective it is. Simple as that.

I hope that helps!


Direct link Reply with quote
 
Pages in topic:   < [1 2]


To report site rules violations or get help, contact a site moderator:

Moderator(s) of this forum
Fernanda Rocha[Call to this topic]
Donatella Cifola[Call to this topic]

You can also contact site staff by submitting a support request »

Technical manuals - The use of "you"







Déjà Vu X2
Enjoy 20% off!

DVX2 Professional is the most popular version of Déjà Vu X2 and with good reason. Fast and flexible, Déjà Vu X2 Professional combines Atril’s Intelligent Quality technology with an array of powerful, customisable productivity and quality assurance

More info »
SDL Trados Studio 2011 Starter Edition
Discover Studio 2011 for only 99€ per year!

SDL Trados Studio 2011 Starter Edition is the new low cost entry-level version of the leading translation memory software. This version is ideal for part-time translators and is a subscription based product. Follow the link to buy or learn more.

More info »