Re: Cross-references on same page

["Brierley, Sean" <Brierley -at- QUODATA -dot- COM>]

Hmmmmm.

>>>-----Original Message-----
>>>From: Doug Nickerson [mailto:doug_nickerson -at- ONSETCOMP -dot- COM]
>>>Sent: Friday, April 30, 1999 9:24 AM
>>>To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
>>>Subject: Re: Cross-references on same page

>>>With changes to the software, and constant review by the marketing
>>>department, a few pages have moved around. I was using actual pages
>>>numbers as cross-references. I've settled on a plan for
>>>cross-referencing
>>>as follows: the phrase "Somewhere else in this User's Guide."

>>>Global replace all cross-references with this phrase to
>>>solve the problem.
>>> :-)

What an excellent idea. If you don't mind I will both implement this idea
immediately and claim the idea as my own.

>>>On a more serious note: they brought in a real technical
>>>writer this week

Uh-oh. What does that mean? A card-carrying STC member (like myself)?
Someone who got an English/writing degree and who has only had career jobs
as a technical writer (like myself, although, I was offered a job as fire
fighter)?

>>>to go over what I have written. In addition to changing my
>>>future tense to
>>>present tense,

Good. And punished you, too.

>>>and changing an occasional passive
>>>construction to active,

Ahhhh. Passive bad. Active good.

>>>and telling me one of my pages was 'half-assed,'  she
>>>advocated this for
>>>cross-references:

Half-assed writing is the bane of all tech writers, everywhere. 'Tis job
security too, at least for us "real" tech writers. <vbg>

>>>For more information, see the section "Off-loading Data."

>>>It doesn't avoid the issue entirely, but sidesteps it.
>>>What do you think?

Off-loading anything, be it data or responsibility, is a good thing. No?

>>>Regards.
>>>
>>>Doug
>>>
>>>Doug Nickerson

Stay safe.

Sean
sean -at- quodata -dot- com

 From ??? -at- ??? Sun Jan 00 00:00:00 0000=