RE: Perform vs. do

Subject: RE: Perform vs. do
From: "Barb" <caslon -at- windstream -dot- net>
To: "'Chris Despopoulos'" <despopoulos_chriss -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sun, 13 Oct 2013 10:08:06 -0400

We can consider changing the construct when we move to a new tool and format
next year. However, there are at five years of docs done by at least eight
writers in this format, with large amounts of reuse (we use Author-it), so
it's not something we can do easily. Also consider that we are short-staffed
by 2 people at the moment.

So for right now, we're taking the baby step of getting standardized on
"perform" vs. "do." I ordered the ASD-STE100 to see what they have to say.

Barb

-----Original Message-----
From: techwr-l-bounces+caslon=windstream -dot- net -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+caslon=windstream -dot- net -at- lists -dot- techwr-l -dot- com] On Behalf
Of Chris Despopoulos
Sent: Sunday, October 13, 2013 4:06 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Perform vs. do

Ok, I'm coming into this late, and I tried to look at these examples, but it
requires that I register to do so.  Anyway, my question is, can't you get
rid of the entire "Perform/Do" construct?  Why not just say...

To foo the bar:
1.  Baz the bongo
2. Bip the bingo
3...

This puts the purpose of the procedure at the head of the steps, reduces
syllables, and gets rid of the problem. 

I agree that "Do the following steps" sounds terrible.  It sounds like
teenager speak.  I'm sure there's a level of analysis concerning mass nouns
in the subject or object or some such that could explain why it's awkward,
but I'm not the one to ferret it out!

cud
>
> If you are a true glutton for punishment, you can download the
> Reference Manual and see the examples in context.
>
> http://www.keithley.com/data?asset=57633
>
> The autozero example is on page 136.
>
> The User's Manual is the one that tends to use the ".... perform the
> following steps" format:
> http://www.keithley.com/data?asset=57632
>
>


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for
authoring.

Learn more: http://bit.ly/ZeOZeQ

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

You are currently subscribed to TECHWR-L as caslon -at- windstream -dot- net -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




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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


Follow-Ups:

References:
Re: Perform vs. do: From: Chris Despopoulos

Previous by Author: RE: Perform vs. do
Next by Author: RE: Perform vs. do
Previous by Thread: Re: Perform vs. do
Next by Thread: Re: Perform vs. do


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

Sponsored Ads


Sponsored Ads