Quote marks, cross-references, multiple presentation forms

Subject: Quote marks, cross-references, multiple presentation forms
From: "Joe Malin" <jmalin -at- tuvox -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 21 Jul 2006 10:52:51 -0700

Hi!

As I finally get all my books finished off, I have run into style
questions for which I'd like to get advice:

1. Somewhere I picked up the habit of putting section names in
double quotes when I make a cross-reference to them. For example, if I
refer to another section in the same chapter, I say

... please see the section "More Stuff" on page 12.

I can't find a citation in Chicago that supports this. Does
anyone have a citation? Am I just making this up?
2. I publish my books to PDF, which means that you can read them
online or print them. For online use, all my cross-references are
hypertext links, but I also put the page number next to them for print
readers. Does this make sense? If I *do* use double quotes around a
section cross-reference, should they be marked distinctively with the
hypertext formatting (blue color, underlining)? Should the page number
be part of the link?
3. If I use distinctive treatment for cross-reference hypertext
links, should I use the same treatment for page numbers in the TOC and
Index? Those are also hypertext links.
4. How should I handle cross-references between chapters and books?
For example, I sometimes have to write

"To learn more about this feature, you can read <blah>" where
<blah> is a section in another chapter or book. I have been writing
<blah> as

in chapter <x> "<title of x>" the section "<section name>" on
page <pagenumber>.

Does that make sense? How much of the cross-reference text
should I include in the hyperlink text?

If you need this re-formatted for clarity, please ask!

Joe


TuVox, Inc.


19050 Pruneridge Avenue Suite 150, Cupertino, CA 95014-0715

Joe Malin
Technical Writer
(408)625.1623
jmalin -at- tuvox -dot- com
www.tuvox.com <http://www.tuvox.com/>
The views expressed in this document are those of the sender, and do not
necessarily reflect those of TuVox, Inc.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.DocToHelp.com/TechwrlList

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: RE: Task Analysis tools
Next by Author: RE: Getting rid of the manual
Previous by Thread: RE: online help vs. online helps
Next by Thread: RE: Quote marks, cross-references, multiple presentation forms


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


Sponsored Ads