Re: The 'user' in User Manual

[Nancy Allison <maker -at- verizon -dot- net>]

I aim for a style that is a mixture of conciseness (80%) and a conversational tone (20%). The percentages indicate that at the end of the writing cycle I do a final search for "you," and try to eliminate it if there is an effective alternative that reads naturally.

Some techniques for avoiding "you" are worse than "you," however. I stay away from the passive voice and from subjectless participles ("While adding the diluent, sing the National Anthem.") I rather like my example here, but usually that construction sounds contorted and odd.

So -- hurray for you -- within limits.

--Nancy


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or 
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList

Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.