Re: introducing steps

Subject: Re: introducing steps
From: John Allred <jack -at- allrednet -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 18 Oct 2011 11:16:24 -0500

My hat's off to Becca for questioning her teacher's pronouncement and sparking a good discussion. This bodes well for a successful career in technical communication.



On Oct 18, 2011, at 9:07 AM, "Gene Kim-Eng" <techwr -at- genek -dot- com> wrote:

> Generally speaking, anytime anyone says "never" do something in a document I wouldn't give the adminishment much credibility. Almost every seemingly bad idea is the right thing to do somewhere.
>
> In this particilar case, my response is that "follow these steps" is ALMOST always unnecessary and your teach is wrong MOST of the time.
>
> Gene Kim-Eng
>
>
> ----- Original Message ----- From: "Becca" <becca_price -at- yahoo -dot- com>
> To: <techwr-l -at- lists -dot- techwr-l -dot- com>
> Sent: Monday, October 17, 2011 5:47 PM
> Subject: introducing steps
>
>
> I'm taking a class in technical writing. My teacher says never to introduce a series of steps with an infinitive (To install Sigil) but to use an independent clause ("To install Sigil, follow these steps:" or words to that effect. To me, the clause "follow these steps" is imlied by the fact that steps follow. Still, it's the teacher, so I have to follow her style.
>
> Is there a more graceful way to introduce steps? how do yo do it? I'm pretty much coming up dry.
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as jack -at- allrednet -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/jack%40allrednet.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/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.
http://www.doctohelp.com

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.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/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
introducing steps: From: Becca
Re: introducing steps: From: Gene Kim-Eng

Previous by Author: Re: Help - my consultants cannot write!
Next by Author: Re: The legalese pages
Previous by Thread: Re: introducing steps
Next by Thread: RE: introducing steps


What this post helpful? Share it with friends and colleagues:


Sponsored Ads