RE: Remember secretaries? (was RE: Proof that content is more important than style)

Subject: RE: Remember secretaries? (was RE: Proof that content is more important than style)
From: cpwinter -at- rahul -dot- net
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 6 Dec 2002 21:24:25 -0800


On 3 Dec 2002, at 11:22, David Downing wrote:

>
> << I would expect most good programmers to also be good at writing.
> The
> cognitive skills are similar. Whether they choose to write text (as
> opposed to writing programs) is another question. It's understandable
> that they might prefer not to exercise the same set of "muscles" on two
> different tasks.>>
>
> Granted, the assertion that computer programmers can't write is a
> stereotype. The problem is that they tend to have trouble writing about a
> piece of software in the terms the end users needs. They tend to think in
> terms of the anatomy of the software, rather than the actions an end-user
> wants to take. The result is that a programmer could produce a beautifully
> written document that was more a set of functional specifications than a
> user manual.
>

Now that I won't argue with. (I mean, that is a statement with which I
will not argue. <g> ) Clearly, programmers must focus on abstract
considerations in order to program effectively. Doing the things that tech
writers do in order to produce effective documents clearly would be a
distraction that would make them less effective at their primary task.

Writing in the sense that professional tech writers do it is obviously far
more than just putting well-composed sentences on paper. But that latter
also falls within the meaning of "writing".

Chris

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

---
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.



References:
RE: Remember secretaries? (was RE: Proof that content is more important than style): From: David Downing

Previous by Author: Re: Programmers as writers?
Next by Author: A sobering encounter
Previous by Thread: RE: Remember secretaries? (was RE: Proof that content is more important than style)
Next by Thread: Re: Remember secretaries? (was RE: Proof that content is more important than style)


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


Sponsored Ads