best wording for cross references

Subject: best wording for cross references
From: kellyk -at- CYBEROPTICS -dot- COM
Date: Wed, 27 Mar 1996 09:50:18 -0600

We don't have a style guide. We don't have enough consistency across
docs, as a result. One area is cross references. Here are some
examples I pulled:

A Turn to Leveling (ital) on page 18.

B For information on blah-blah-blah, refer to yadda-yadda-yadda.

C See "Solving Measurement Problems" on page 72.

Should a page number be included? Excluded?

One writer here prefers using example C. He feels 'Turn to' rhymes,
and that's not good. (I did explain that there was no rhyme; it was
actually the alliteration in 'Turn to' that he did not like.)

A third writer here uses example B.

What do your style guides say? What is your preference? Do any
reference materials you use deal with cross reference format?

Send responses to: kellyk -at- cyberoptics -dot- com

Thanks.

Kelly M. Kremin
CyberOptics Corp
Minneapolis MN


Previous by Author: [no subject]
Next by Author: Questions on Softback Institute's Conference and Expo
Previous by Thread: Re: writing and liability
Next by Thread: Re: best wording for cross references


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

Sponsored Ads


Sponsored Ads