RE: Writing clearly

Subject: RE: Writing clearly
From: "Kieran Sullivan" <ksullivan -at- tssg -dot- org>
To: "'Pinkham, Jim'" <Jim -dot- Pinkham -at- voith -dot- com>, "'Technical Writing Plus'" <doc-x -at- earthlink -dot- net>, "'Tekwrl'" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 20 May 2010 15:27:47 +0100

'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:

http://www.plainenglish.co.uk/files/reportsguide.pdf

(p.19)

Regards,
Kieran.

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

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/jim.pinkham%40voith.c
om


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 ksullivan -at- tssg -dot- org -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/ksullivan%40tssg.org


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


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-

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/archive%40web.techwr-l.com


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


References:
Re: Writing clearly: From: 'Technical Writing Plus'
RE: Writing clearly: From: Pinkham, Jim

Previous by Author: RE: Writing clearly
Next by Author: Re: Two questions about Copyright notices
Previous by Thread: RE: Writing clearly
Next by Thread: Re: Writing clearly


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

Sponsored Ads


Sponsored Ads