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.
'How to write reports in plain English', from the Plain English Campaign
mentions the "jot list" method and the mind-mapping method for planning the
writing of a report:
________________________________________
Kieran Sullivan
Telecommunications Software & Systems Group, (www.tssg.org)
Waterford Institute of Technology, (www.wit.ie)
Tel: +353 51 302915
E-Mail: ksullivan -at- tssg -dot- org
Blog: http://pureprose.wordpress.com/
-----Original Message-----
From: techwr-l-bounces+ksullivan=tssg -dot- org -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+ksullivan=tssg -dot- org -at- lists -dot- techwr-l -dot- com] On Behalf Of
Pinkham, Jim
Sent: 20 May 2010 15:18
To: Technical Writing Plus; Tekwrl
Cc: Dana Worley
Subject: RE: Writing clearly
Exactly! The "jot list," as it's sometimes called, can prove a useful
way to begin to organize your thoughts as a preface to knowing what you
wish to say before you say it.
Great discussion, BTW. In addition to the aforementioned Strunk & White,
and "Politics and the English Language," I'd propose "The Lively Art of
Writing" and "Simple and Direct" as helpful resources on expository
writing.
There's also a fine chapter on "The Writer's Art" in my edition of
Mencher's "News Reporting and Writing." I especially like this pithy
advice in one of the glossies: "Facts first, words second." Mencher goes
on to develop the theme that it's more important to be clear and
accurate in non-fiction writing than it is to be creative and colorful
in our diction and delivery. Good advice.
-----Original Message-----
From: techwr-l-bounces+jim -dot- pinkham=voith -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+jim -dot- pinkham=voith -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of 'Technical Writing Plus'
Sent: Thursday, May 20, 2010 8:21 AM
To: Tekwrl
Cc: Dana Worley
Subject: Re: Writing clearly
Dana, I do not believe that you are disagreeing. What you are doing is
this: Sometimes you are using written expression to discover what it is
that you want (or need) to say. This idea does not go against what the
'knowing exactly what it is' thing at all. Jim
-----Original Message-----
>From: Dana Worley <dana -at- campbellsci -dot- com>
>Sent: May 20, 2010 8:01 AM
>To: techwr-l -at- lists -dot- techwr-l -dot- com
>Subject: Re: Writing clearly
>
>On Wednesday, May 19, 2010, 'Technical Writing Plus' wrote:
>
>> But you always should know exactly what it is that you want to say
>> (before you put pen to paper).
>
>I disagree with this point. If I am having trouble knowing where to
>start, I will begin by typing a random list of relevant points and work
>from there. In other words, I don't always know exactly what I want to
say, but I do have an idea of the points that need to be covered.
>
>I don't think my writing is more or less clear because of this, but it
>certainly helps with composition.
>
>:) Dana W.
>
>
>
> ***************************
>Dana Worley
>Software Product Manager/Manager, Software Support Group Campbell
>Scientific, Inc.
>Microsoft MVP, Windows Help
>
>www.jestersbaubles.etsy.com
>
>^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
>Gain access to everything you need to create and publish documentation,
>manuals, and other information through multiple channels. Choose
>authoring (and import) as well as virtually any output you may need.
>http://www.doctohelp.com/
>
>
> - Use this space to communicate with TECHWR-L readers -
> - Contact admin -at- techwr-l -dot- com for more information -
>
>
>---
>You are currently subscribed to TECHWR-L as doc-x -at- earthlink -dot- net -dot-
>
>To unsubscribe send a blank email to
>techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
>or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/doc-x%40earthlink.ne
>t
>
>
>To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
>Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwr-l.com/ for more resources and info.
>
>Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
Gain access to everything you need to create and publish documentation,
manuals, and other information through multiple channels. Choose
authoring (and import) as well as virtually any output you may need. http://www.doctohelp.com/
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
---
You are currently subscribed to TECHWR-L as Jim -dot- Pinkham -at- voith -dot- com -dot-
Gain access to everything you need to create and publish documentation,
manuals, and other information through multiple channels. Choose
authoring (and import) as well as virtually any output you may need. http://www.doctohelp.com/
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
---
You are currently subscribed to TECHWR-L as ksullivan -at- tssg -dot- org -dot-
No virus found in this incoming message.
Checked by AVG - www.avg.com
Version: 9.0.819 / Virus Database: 271.1.1/2884 - Release Date: 05/19/10
19:26:00
Gain access to everything you need to create and publish documentation,
manuals, and other information through multiple channels. Choose
authoring (and import) as well as virtually any output you may need. http://www.doctohelp.com/
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
