Re: Single Note and multiple Notes

Subject: Re: Single Note and multiple Notes
From: Nelson Vargas <nelson -dot- vargas -at- gmail -dot- com>
To: Thorsten Konersmann <tk -at- documentation -dot- engineering>
Date: Tue, 19 Apr 2022 18:15:00 -0400

Thank you, Everyone! Those were great answers, very helpful. And Thorsten's
point, "Signal words (and their translations in the standardâs annex) are
only ever listed and used as singulars," sold me on singular.

Gratefully,
Nelson

On Tue, Apr 19, 2022 at 4:29 PM Thorsten Konersmann
<tk -at- documentation -dot- engineering> wrote:

> When such questions come up, I look for public style guides and industry
> standards.
>
> The ANSI Z535.6-2011 (R2017) standard on product safety information comes
> to my mind first in this case because it defines signal words for safety
> messages (corresponding to levels of risk, namely âDANGER,â âWARNING,â
> âCAUTION,â and âNOTICEâ).
>
> The âNoteâ heading in your question is similar to signal words, and the
> standard is analogous to your example as it explicitly allows to combine
> multiple safety messages into one.
>
> The question of singular vs. plural for signal words, however, is
> discussed not once in this standard. There is no mentioning of, for
> example, when to use the plural âWARNINGSâ instead of âWARNINGâ (which
> makes sense to me considering their purpose of signaling levels of risk).
>
> Signal words (and their translations in the standardâs annex) are only
> ever listed and used as singulars.
>
> ANSI Z535.6:
> https://webstore.ansi.org/standards/nema/ansiz5352011r2017-1668876
>
>
>
> On Tue 19. Apr 2022 at 20:24 Nelson Vargas <nelson -dot- vargas -at- gmail -dot- com>
> wrote:
>
>> Dear List,
>>
>> My colleagues and I are wondering how best to handle the situation where
>> we
>> include a single note anywhere in our content or multiple Notes. The
>> specific issue we are puzzling over is whether to title a list of notes
>> with the word Note or the plural form Notes. Our only reason for going
>> with
>> the singular is to avoid forgetting to add the s when using the plural.
>> It's simpler to just add Note everywhere.
>>
>> This came up after we decided to move away from using a run-in title with
>> just Note for every individual note. In our Help, that often appear a bit
>> heavy, so we're trying a bulleted list with either Note or Notes as the
>> signal word.
>>
>> With Gratitude,
>> Nelson Vargas
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> Visit TechWhirl for the latest on content technology, content strategy
>> and content development | https://techwhirl.com
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> You are currently subscribed to TECHWR-L as tk -at- documentation -dot- engineering -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
>>
> --
> Von unterwegs gesendet | Sent from my mobile
>
> http://www.documentation.engineering/
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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


Follow-Ups:

References:
Single Note and multiple Notes: From: Nelson Vargas
Re: Single Note and multiple Notes: From: Thorsten Konersmann

Previous by Author: Single Note and multiple Notes
Next by Author: Re: Single Note and multiple Notes
Previous by Thread: Re: Single Note and multiple Notes
Next by Thread: RE: Single Note and multiple Notes


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


Sponsored Ads