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

[Lin Sims <ljsims -dot- ml -at- gmail -dot- com>]

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