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.
I agree with you, my argument is that should be one thing or the other â not both.
I disagree on the colour, it performs the job you describe of indicating where the note ends.
From: mbaker -at- analecta -dot- com [mailto:mbaker -at- analecta -dot- com]
Sent: 16 October 2018 14:22
To: Sion Lane <sion -dot- lane -at- unit4 -dot- com>; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Note styles
Drop the Icon. Drop the color. Add the word "Note".
The principles involved here are very simple:
* Be clear
* Avoid redundancy
The word "Note" is the clearest way to point out that something is a note. People might not know that the icon means. They might not know what the color means. They will certainly know what "Note" means.
Since the word "Note" is sufficient to indicate that a note is a note, the icon and the color are redundant and should be removed. You do need some kind of formatting to indicate where a note ends, such as a box or indentation of the note, but this should be the minimum necessary to do the job.
Mark
On 2018-10-16 8:53:03 AM, Sion Lane <sion -dot- lane -at- unit4 -dot- com<mailto:sion -dot- lane -at- unit4 -dot- com>> wrote:
We currently use appropriate icons, indentation and a different background to indicate notes, tips and warnings in our help topics and pdf content. A proposal has been made that we also use autonumbering to add the word 'Note' 'Tip' etc.
I feel this is overkill, the icon in conjunction with the background colour act as a visual representation of that word so to add the word as well makes it almost tautological. The nature of the message should also be obvious from the text itself. I should add that we do not currently have an 'About this Help' topic that explains the icons and there is no desire to add one.
What are other people's opinions?
Am I crazy to be so bothered about this?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com
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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com