Using the word "you" in an user manual

Posted by yan bellavance on Stack Overflow See other posts from Stack Overflow or by yan bellavance
Published on 2010-05-27T16:52:03Z Indexed on 2010/05/27 17:01 UTC
Read the original article Hit count: 277

Filed under:

technical-writing

|

manuals

|

reference-manual

I am writing a user manual and I have come to a discussion with a colleague. He says I cannot use the word "you" anywhere in the manual. Now I remember something about this at school but that was not for writing procedures. Also, doing some googling I observed that most tutorials where using it a lot. I would prefer using it but only if this is considered good practice. what do you think?

© Stack Overflow or respective owner

Related posts about technical-writing

Run On Sentences in Technical Writing

as seen on Programmers - Search for 'Programmers'
This is just a question to think about. When you write technical documentation and programming comments, do you ever find yourself writing run-on sentences in order to be more precise? Is packing more technical information into one sentence better than creating many little sentences each with a… >>> More
What markup languages are good for programming articles/tutorials?

as seen on Programmers - Search for 'Programmers'
I very much wish to write a programming tutorial in my native language (Latvian). There are far too few of those. I am however unsure on what markup language to use for writing it. Here are a few things I would like to achieve: The same source can be compiled to both HTML for online viewing and… >>> More
Editing service for blogger with terrible English grammar

as seen on Programmers - Search for 'Programmers'
I would like to write a technical blog. However, the biggest things holding me back is my poor spelling, punctuation, and grammar (I have all these problems even though I am a native English speaker). I am thinking about using a professional editing/proofreading service to fix my blog posts before… >>> More
Dealing with Word spell check in technical documents?

as seen on Super User - Search for 'Super User'
I have waste millions of hours clicking the Ignore Once button in Word, while trying to spell check a document related to development. Be that something light on terms like a proposal or something worse like technical specs. I'm beginning to think that this is a huge waste and someone may have developed… >>> More
Where can I find someone to write a web article for me?

as seen on Super User - Search for 'Super User'
I am familiar with RentaCoder, but is there a service where I can ask somone to write me an article or add some copy to my web site? Thanks! >>> More

Related posts about manuals

Concentrating on tedious manuals

as seen on Programmers - Search for 'Programmers'
Reading manuals is often boring — sometimes so boring that it becomes all but impossible to focus on the task. Yet.. so essential. As frustrating as it is to have to reread the same 2-page section four times in order to finally read the whole thing the whole way through without mentally skipping… >>> More
T38modem manuals?

as seen on Server Fault - Search for 'Server Fault'
Are there any T38modem users here? I'm trying to figure out how to call T38modem with SIP. I've got everything except the --route option for receiving. I know my own phone number, but I am not sure how to set it up. Currently, I have: --route "modem:0.*"="sip:<dn>@64.136.174.30" --route… >>> More
where to download emacs manuals as offline html files

as seen on Super User - Search for 'Super User'
When you press C-h i in Emacs, it shows what's called the top of the INFO tree, and it links to all kinds of manuals: AUCTeX, Org Mode, Emacs, Emacs FAQ, Emacs Lisp Intro, Elisp, ... . Is there a place where I can download all of them at once as html files? GNU Home page has links to some of them… >>> More
Where to get all versions of x86 aka IA32 Instruction Set Architecture manuals

as seen on Stack Overflow - Search for 'Stack Overflow'
Hello, I know about Intel 64 and IA-32 Architectures Software Developer's Manuals. I also know that these cover all the legacy & old processor ISAs. But I want the individual manual (the one that released along with the processor) for each of the processors. I managed to find the 80386 manual >>> More
Download the ‘Getting Started with Ubuntu 12.04' Manual for Free

as seen on How to geek - Search for 'How to geek'
If you or someone you know is new to Ubuntu, then the release of this free 143 page manual for the latest LTS edition of Ubuntu is the perfect download. The manual will take you from installing Ubuntu 12.04 all the way through to trouble-shooting the system if you run into problems. On the downloads… >>> More