RE: introducing steps

Subject: RE: introducing steps
From: "Arnold, Ann" <Ann -dot- Arnold -at- kla-tencor -dot- com>
To: "Peter Sturgeon" <prsturgeon -at- bell -dot- net>, <becca_price -at- yahoo -dot- com>, "techwrl" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 18 Oct 2011 06:44:34 -0700

That is a good point. However, at a previous job we removed intro
sentences for localization and saved a lot of money--so it depends on
your localization budget, too. :-)

If the heading makes it clear what the following steps are for, not sure
why you need the intro sentence for clarity.

My two cents.

-----Original Message-----
From: techwr-l-bounces+ann -dot- arnold=kla-tencor -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+ann -dot- arnold=kla-tencor -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Peter Sturgeon
Sent: Tuesday, October 18, 2011 8:29 AM
To: becca_price -at- yahoo -dot- com; techwrl
Subject: RE: introducing steps


This thread ignores translation. Making the introductory phrase a
complete grammatical sentence makes it easier for translators and
non-native speakers of English to understand the procedure.

By starting with a infinitive phrase, every subsequent step is
grammatically part of a potentially very long serial sentence.

By starting with a complete grammatical sentence, each step acts as an
independent sentence.

Just sayin'


----------------------------------------
> Date: Mon, 17 Oct 2011 17:47:31 -0700
> From: becca_price -at- yahoo -dot- com
> Subject: introducing steps
> To: techwr-l -at- lists -dot- techwr-l -dot- com
>
> 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.
>
> Thanks
>
> Becca
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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 Ann -dot- Arnold -at- kla-tencor -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/ann.arnold%40kla-tenc
or.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: Peter Sturgeon

Previous by Author: RE: introducing steps
Next by Author: Introducing steps
Previous by Thread: RE: introducing steps
Next by Thread: RE: introducing steps


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


Sponsored Ads