Re: Note versus Tip

Subject: Re: Note versus Tip
From: "Peter Neilson" <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 10 Feb 2015 15:37:18 -0500

On Tue, 10 Feb 2015 14:43:21 -0500, Sean Brierley <sean -dot- brierley -at- gerberscientific -dot- com> wrote:

Hi all,

A search yields nothing. Anyone know of a study that identifies if having a
both a note and a tip in technical communication is useful. that is, if a
tip is an optional thing that helps you finish a task more efficiently, and
a note contains information that affects successful completion of a task,
is there a study that tells us whether our audience cares about the


Here's a note to say that my own impromptu study, completed just seconds ago, reports that no one, nobody at all, gives a hoot except technical writers. Presentation of information as a side issue suggests to me that the writer is contemplating talking down to me.

If there are six important points that I'd better know to prevent utter destruction of the frammis blotter, I'd really like to see them presented this way:

You should become thoroughly familiar with these six points to prevent utter destruction of the frammis blotter:
1. Antimony mumble
2. Arsenic fumble
3. Aluminum grumble
4. Selenium trumble
5. Hydrogen splather
6. Oxygen kaputnik
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word |


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 for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Note versus Tip: From: Sean Brierley

Previous by Author: RE: RE: [RMX:NL] HELP! RoboHelp numbering in snippets
Next by Author: Proofreading your own material
Previous by Thread: Re: Note versus Tip
Next by Thread: Re: Note versus Tip

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

Sponsored Ads