RE: Technical writing in a higher ed environment

Subject: RE: Technical writing in a higher ed environment
From: "Wendy Cunningham" <wcunning -at- pct -dot- edu>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 19 Mar 2004 21:36:35 -0500


I guess I should have remembered how literal technical writers are
(myself included). I really didn't mean "clarity above all else." Of
course the meaning and clarity come first (assumed we all agreed on that
point). I guess I overstated my case. I meant only to say that
consistency, even at the sentence level, is very important. Keep in
mind that the example I gave was just that--an example, certainly not
the only problem I have with AP. Admittedly, 'style' is as much about
personal preference as anything else.

RE the statement about "consistent documentation across all internal
documentation"... that's really not the situation. I'm the only person
really churning out "documentation"; most other content coming out of
the institution is of a marking/public relations nature. I don't think
anyone much cares what style I use for internal documentation. But,
since I'm providing some of the information via the Web, it is seen as
'publicly accessible.' Hense the need to comply with AP.

Sheesh... thought I was asking for support, perspective, and experience.
Instead I get a lashing... <grin>...


>>> "Lisa Wright" <liwright -at- earthlink -dot- net> 03/19/04 5:14 PM

>>>
Wendy,
I'm going to have to disagree with you on this one (I know it's
Friday...sorry). You say that "Technical writers are trained to honor
consistency above all else." What I was taught to be most important is
clarity and effectiveness in the content. ...

Also, if we're looking at consistency, there is a valid argument to be
made for having consistent documentation across all internal
publications.





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

ROBOHELP X5 - ALL NEW VERSION. Now with Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!

Now is the best time to buy - special end of month promos, including:
$100 mail-in rebate; Free online orientation on content management
functionality; Huge savings on support and future product releases;
PLUS Great discounts on RoboHelp training. OFFER EXPIRES March 31!
Call 1-800-358-9370 or visit: http://www.ehelp.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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: Technical writing in a higher ed environment
Next by Author: RE: Technical writing in a higher ed environment
Previous by Thread: RE: RE: Technical writing in a higher ed environment
Next by Thread: RE: Technical writing in a higher ed environment


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


Sponsored Ads