TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
RE: Teaching a practical business writing class and looking forprofessional rubrics
Subject:RE: Teaching a practical business writing class and looking forprofessional rubrics From:"Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com> To:"Nancy Allison" <maker -at- verizon -dot- net>, <klhra -at- yahoo -dot- com> Date:Tue, 18 Aug 2009 08:26:19 -0700
You crack me up, Nancy. Your first post rightly stresses the importance
of usability (i.e. writing to your target audience). Your second post
suggests that Keith missed the gist of your message because he wasn't
reading "attentively." To me, this looks like the epitome of whim (i.e.,
"subject to unpredictable change").
Leonard
-----Original Message-----
From: techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- c
om] On Behalf Of Nancy Allison
Sent: Tuesday, August 18, 2009 7:44 AM
To: klhra -at- yahoo -dot- com
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re:Teaching a practical business writing class and looking
forprofessional rubrics
Keith: Everything you describe is what I put under the category of
"problem-solving." As you will recall, I said that the problem-solving
of our work employs all the creativity we have. Page layout, avoidance
of repetition, avoidance of jargon, clearly calling out important
information (it's not enough that the information be there; the reader
has to be able to recognize that it is there), and so on and so forth --
all of these questions involve our creativity, in all sorts of ways.
I am not oposed to creativity and I hope that anyone who read my post
attentively would have understood this.
I am opposed to the use of the writer's role as a gratification of
personal whimsy.
Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices. http://www.doctohelp.com/SuperPages/Webcasts/
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-