Re: [BULK] Re: Use of word "reference" when cross referencing

Subject: Re: [BULK] Re: Use of word "reference" when cross referencing
From: Lin Sims <ljsims -dot- ml -at- gmail -dot- com>
To: Gene Kim-Eng <techwr -at- genek -dot- com>
Date: Wed, 15 Aug 2018 12:57:19 -0400

He's been here about 3 years, so most of the docs here use the phrase
"Reference <something> for more information." I'm willing to use it, even
if it gives me acid, as long as it's correct usage. Since I wasn't having
luck finding cites, I figured I'd ask around.

I may bring up the "use the $1 word, not the $10 one" argument at some
point, but there are better hills to die on than this. Heck, I just
finished copyediting one of his docs and didn't change ONE of them! :-D

(Note: I never use the word "please" when writing instructions. It's fluff,
and as remarked upthread, implies the instruction is an option rather than
a requirement.)

On Wed, Aug 15, 2018 at 12:27 PM, Gene Kim-Eng <techwr -at- genek -dot- com> wrote:

> Lin posted this question in the context of a discussion with a co-worker.
> The key to what to do here is in whether it's just two writers disagreeing
> about what to do in new documents, or if the company's existing documents
> are already doing it.
>
> Gene Kim-Eng
>
>
> On 8/15/2018 7:47 AM, Mike McCallister wrote:
>
>> I like Gene's idea here. Our mainframe docs have had this use of
>> "reference" for a very long time, usually when citing IBM documentation
>> that we don't directly link to. It still jars me when I read it. If I'm
>> editing some section for another reason, I will often change 'reference' to
>> 'see,' but only if it makes sense.
>>
>
>
> ---
> This email has been checked for viruses by Avast antivirus software.
> https://www.avast.com/antivirus
>
>


--
Lin Sims
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://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:
Use of word "reference" when cross referencing: From: Lin Sims
Re: Use of word "reference" when cross referencing: From: Gene Kim-Eng
RE: [BULK] Re: Use of word "reference" when cross referencing: From: Mike McCallister
Re: [BULK] Re: Use of word "reference" when cross referencing: From: Gene Kim-Eng

Previous by Author: Re: Use of word "reference" when cross referencing
Next by Author: For references or directives, do you say where/why and then what/how, or vice versa?
Previous by Thread: Re: [BULK] Re: Use of word "reference" when cross referencing
Next by Thread: Re: [BULK] Re: Use of word "reference" when cross referencing


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

Sponsored Ads


Sponsored Ads