RE: Blurring the line between writer and engineer

Subject: RE: Blurring the line between writer and engineer
From: "David Artman" <david -at- davidartman -dot- com>
To: "Rick Lippincott" <rjl6955 -at- gmail -dot- com>, "TECHWR-L Writing" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 15 Dec 2015 08:19:52 -0700

I have only ever effected HW changes when I've pointed out poor design
for serviceability while writing service procedures (e.g., relocate
screws or add cutouts).

VERY rare.

I often point out SW changes that could/should be made, especially when
I find myself written into a corner (e.g., when I realized I was having
to write "click the upper Add button" versus "click the lower Add
button", I suggested adding field labels or renaming the Add buttons to
distinguish them). Or when I find myself writing bad grammar to quote a
field name or message (i.e., a 'bug' in the text itself, requiring a
correction in code). Or when I find that controls on a screen are
inconsistently structured or worded (i.e., incoherent/sloppy).

VERY common, especially in 'Agile development' environments that don't
quite understand that "Agile" <> "no planning or design discussion".
:-)

David

-------- Original Message --------
Subject: Blurring the line between writer and engineer
From: Rick Lippincott <[1]rjl6955 -at- gmail -dot- com>
Date: Mon, December 14, 2015 6:41 pm
To: TECHWR-L Writing <[2]techwr-l -at- lists -dot- techwr-l -dot- com>
...

Two questions, just out of curiosity:
* For hardware tech writers (especially large "heavy metal" writers),
do you find that you're doing this...frequently? Rarely? Ever?
* For software tech writers...do you ever find that you're writing
code?

References

1. mailto:rjl6955 -at- gmail -dot- com
2. mailto:techwr-l -at- lists -dot- techwr-l -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.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-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


Previous by Author: RE: What do you call the triangle-twist-open thingie?
Next by Author: Re: Accidental à in html ... how?
Previous by Thread: Re: Blurring the line between writer and engineer
Next by Thread: Re: Blurring the line between writer and engineer


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


Sponsored Ads