RE: Thinking Patterns (was RE: Interviews (5 Year Question))

Subject: RE: Thinking Patterns (was RE: Interviews (5 Year Question))
From: "John Fleming" <johnf -at- ecn -dot- ab -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 19 Jun 2001 18:02:01 -0600

Subject: RE: Thinking Patterns (was RE: Interviews (5 Year Question))
From: Jim Shaeffer <jims -at- spsi -dot- com>
Date: Mon, 18 Jun 2001 08:25:21 -0400
X-Message-Number: 5

> Referring to the original examples, a sequential procedure is also
> easier to program in a computer language than any process that
> involves if statements. In fact, the examples given are simply
> examples of technical writing that is programming certain behaviors
> into human beings rather than programming the behavior into
computers.
> While neither example is terribly complex, having more decision
> points causes more complexity and more likely points of failure.

Well, on example 2 I did cut the complexity short. I wanted a
comparatively quick example that illustrated the fun of documenting
something with decision points.

While I could have got a bit more complex, I didn't feel it was
necessary.

Believe me, our documentation coordinator doesn't exactly look forward
to me tossing the next chapter in the "Great Canadian Novel" in her
direction. She'd be a bit happier with a series of two page
procedures.

> Better programmers can handle more complex situations. Better tech
> writers can handle more complex situations.

Good point.

> However, I think it may be easier for us as tech writers to avoid
> complex situations for long stretches of time.
> Then, when we do need to address them, our tools are rusty.

Also good.

Whether we avoid them intentionally or not is, I suppose, dependent to
some extent on the environment we find ourselves in.

If the products and processes we are documenting lend themselves to
short sequential instructions, then those long stretches are forced
upon us. If we are in situations where the complex is the norm, then
we develop the skills faster.

--

John Fleming
Technical Writer
Edmonton, Alberta
email: johnf -at- ecn -dot- ab -dot- ca



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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at http://www.devahelp.com or info -at- devahelp -dot- com

Sponsored by Cub Lea, specialist in low-cost outsourced development
and documentation. Overload and time-sensitive jobs at exceptional
rates. Unique free gifts for all visitors to http://www.cublea.com

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: Re: Thinking Patterns (was RE: Interviews (5 Year Question))
Next by Author: Re: New TECHWR-L Poll Question
Previous by Thread: Re: Thinking Patterns (was RE: Interviews (5 Year Question))
Next by Thread: Need advice for a sticky situation


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


Sponsored Ads