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.
Subject:Re: Note versus Tip From:Laura Lemay <lemay -at- lauralemay -dot- com> To:Techwr-l <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 10 Feb 2015 12:59:50 -0800
Note (cough) that MSTP defines notes and tips as distinct things.
I think it is pointless to separate them but I had to wrestle with an ex-Microsoft writer for them (and lost).
Laura
On Feb 10, 2015, at 12:20 PM, Bridget Gordan <bridget -dot- gordan -at- gmail -dot- com> wrote:
> Where I work now does this. I find it distracting. At my last job, where I
> ruled the doc world, I incorporated notes into the text and just had tips
> identified with a label.
>
> Bridget
>
> On Tue, Feb 10, 2015 at 2:43 PM, 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
>> difference?
>>
>> Thoughts?
>>
>> Sean
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy &
>> Procedure Guides, eBooks, and more using Microsoft Word |
>> http://bit.ly/doctohelp2015
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> You are currently subscribed to TECHWR-L as bridget -dot- gordan -at- gmail -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
>> http://www.techwhirl.com/email-discussion-groups/ for more resources and
>> info.
>>
>> Looking for articles on Technical Communications? Head over to our online
>> magazine at http://techwhirl.com
>>
>> Looking for the archived Techwr-l email discussions? Search our public
>> email archives @ http://techwr-l.com/archives
>>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as lemay -at- lauralemay -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
>http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
>
> Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015