Cross-reference style question

Subject: Cross-reference style question
From: Nancy Allison <maker -at- verizon -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 01 Dec 2009 08:38:22 -0600 (CST)

I'm working in a long document that has internal TOCs at the beginning of each chapter.

They are presented in a simple list format, using the same x-ref formatting that is used in sentences. It's quick and easy but possibly not really stylistically acceptable. By that I mean, not stylistically acceptable TO ME. I'm wondering if my ideas of acceptability are stuck in, say, the 80s. It looks like this:

This chapter contains the following sections:

-- "Opening Your Toaster Box" on page 37
-- "Plugging in Your Toaster" on page 42
-- "Burning Your Toast" on page 67

Each bulleted item is a hyperlink and is formatted in blue ink, so that when people read the PDF online, they know they can click to go directly to that section. When the document is printed on a color printer, the text is blue, which may seem slightly odd, but the page number is provided so the reader can find the section.

Although it looks a bit kludgy to me, it is much easier to maintain than having two lists marked with conditional text:

--One has the blue hyperlink, no quotation marks, and no page numbers
--One has the quotation marks and page numbers, but no hyperlink

The two-formats-marked-with-conditional-text is what I have done in other documents, but I'm wondering if I am making work for myself and anyone else who has to maintain the docs.

Would you accept this alternate formatting? If not, what would you do instead?



Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:

Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive.

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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Previous by Author: RE: consolas font's hyphen - causing odd copy/paste result from PDF(from FrameMaker)
Next by Author: Cross-reference style question
Previous by Thread: Re: New Poll Question
Next by Thread: Re: Cross-reference style question

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

Sponsored Ads