RE: Which style of giving instructions is more effective?

[Kat Kuvinka <katkuvinka -at- hotmail -dot- com>]

Oh, we could trim it even more but it's the cold season ;^)
 
(here...in the great NE US...)
 
> 
> Kat got an editing knife and knows how to use it....
> 
> -----Original Message-----
> From: techwr-l-bounces+ccardimon=m-s-g -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+ccardimon=m-s-g -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Kat Kuvinka
> Sent: Wednesday, December 19, 2012 2:37 PM
> To: Roberta Hennessey; Ryan Pollack
> Cc: techwr-l -at- lists -dot- techwr-l -dot- com
> Subject: RE: Which style of giving instructions is more effective?
> 
> To restart the device, enter <command itself>
> 
> Trim some of the fat.
> 
> 
> > 
> > IMHO, Restart is more active.
> > 
> > 
> > 
> > On Wed, Dec 19, 2012 at 12:24 PM, Ryan Pollack <ryan -at- clicksecurity -dot- com>wrote:
> > 
> > > Hi all,
> > >
> > > I'm debating the merits of two different styles of commands:
> > >
> > > "Enter the following command to restart the device:"
> > >
> > > (followed by the command itself)
> > >
> > > and
> > >
> > > "Restart the device by entering the following command:"
> > >
> > > (followed by the command itself)
> > >
> > > I've been flipping back & forth on these for years; now that I am 
> > > creating a new documentation set, I'd like to be consistent, if that 
> > > is even possible (or desirable).
> > >
> > > Any thoughts on the relative merits of each style? Situations when 
> > > either would be useful? etc.
> > >
> > > Thanks for your input!
> > >
> > > --
> > >
> > > Ryan Pollack
> > > Senior Technical Writer | Click Security 
> > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > > Writer Tip: Create 10 different outputs with Doc-To-Help -- 
> > > including Mobile and EPUB.
> > >
> > > Read all about them: http://bit.ly/doc-to-help-10-outputs
> > > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > >
> > > You are currently subscribed to TECHWR-L as rahennessey -at- gmail -dot- com -dot- 
> > >
> > > To unsubscribe send a blank email to 
> > > techwr-l-leave -at- lists -dot- techwr-l -dot- com
> > >
> > >
> > > Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit 
> > > http://www.techwhirl.com/email-discussion-groups/ for more resources 
> > > and info.
> > >
> > > Looking for articles on Technical Communications? Head over to our 
> > > online magazine at http://techwhirl.com
> > >
> > > Looking for the archived Techwr-l email discussions? Search our 
> > > public email archives @ http://techwr-l.com/archives
> > >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > Writer Tip: Create 10 different outputs with Doc-To-Help -- including Mobile and EPUB.
> > 
> > Read all about them: http://bit.ly/doc-to-help-10-outputs
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > 
> > You are currently subscribed to TECHWR-L as katkuvinka -at- hotmail -dot- com -dot- 
> > 
> > To unsubscribe send a blank email to
> > techwr-l-leave -at- lists -dot- techwr-l -dot- com
> > 
> > 
> > Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit 
> > http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
> > 
> > Looking for articles on Technical Communications? Head over to our 
> > online magazine at http://techwhirl.com
> > 
> > Looking for the archived Techwr-l email discussions? Search our public 
> > email archives @ http://techwr-l.com/archives
> 
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Writer Tip: Create 10 different outputs with Doc-To-Help -- including Mobile and EPUB.
> 
> Read all about them: http://bit.ly/doc-to-help-10-outputs
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> 
> You are currently subscribed to TECHWR-L as ccardimon -at- m-s-g -dot- com -dot- 
> 
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
> 
> 
> Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
> 
> Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
> 
> Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
> Information contained in this e-mail transmission is privileged and confidential. If you are not the intended recipient of this email, do not read, distribute or reproduce this transmission (including any attachments). If you have received this e-mail in error, please immediately notify the sender by telephone or email reply.
 		 	   		  
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Writer Tip: Create 10 different outputs with Doc-To-Help -- including Mobile and EPUB.

Read all about them: http://bit.ly/doc-to-help-10-outputs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives