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

Subject: Re: [BULK] Re: Use of word "reference" when cross referencing
From: Lauren <lauren -at- writeco -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 15 Aug 2018 13:32:47 -0700

From page 997 of the Microsoft Writing Style Guide pdf I just downloaded,
"Apply the same sentence structures to similar information. For example, use prepositional phrases
consistently in procedures to help customers navigate menus and dialog boxes. And use the same syntax for
cross-references and other common content elements."

Page 470 offers this,
"Don't use as a noun to refer to cross-references to other pages or to hyperlinks.
Don't use as a verb to refer to going from one link to another. Use go to instead."

References are preceded by "See also" throughout the document.


On 8/15/2018 11:25 AM, Lin Sims wrote:

<nod> I've had the link to their online version, but so far have not
managed to find anything in it addressing the preferred way of referring to
information located elsewhere. Although there are plenty of examples on
every page showing the use of "For more information about <subject>, see
<topic>." That's how I used to word that sort of thing, then it got beaten
out of me at one of my prior jobs where the house style was "See <topic>
for more information."

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

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
Re: [BULK] Re: Use of word "reference" when cross referencing: From: Lin Sims

Previous by Author: Re: [BULK] Re: Use of word "reference" when cross referencing
Next by Author: Re: [BULK] Re: Use of word "reference" when cross referencing
Previous by Thread: Re: [BULK] Re: Use of word "reference" when cross referencing
Next by Thread: RE: Use of word "reference" when cross referencing


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

Sponsored Ads


Sponsored Ads