Re: Capitalization - current trends?

Subject: Re: Capitalization - current trends?
From: Dick Margulis <margulis -at- fiam -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 05 Mar 2001 12:45:54 -0500

Okay, let me revise my earlier response. In the example Donn cites, Read
and Write are the proper names of the operations. There are lots of read
operations in the world of computers, but the one I'm referring to right
now has a name, and the name is _Read_.

In the situation Janice and others describe, referring to the name of
something that is downstyled in its native habitat, such as a section
heading, the approach I've taken is to upstyle it in the reference,
again treating it as a proper noun. For example, if a heading is "Theory
of operations," I might say in the text, "... as described in Theory of
Operations, above." This comes up frequently in a different context,
writing about features of a UI. On the UI itself, we like to downstyle
labels. So we might have a label that says, "Project short name"; but we
might have a sentence in a training guide or Help that says, "the
Project Short Name field accepts up to twelve characters." That's a
lousy example, because we would obviously rewrite it to avoid the issue;
but sometimes we do have to refer to things this way.

Anyway, this is one way to approach the situation. Others are equally


Donn Le Vie wrote:

For example, a device can read or write bits to a register, but there
also Read and Write operations, shortened to something like..."when the
thingamajig performs a Read to the BFD register..."


Janice Gelb wrote:

> I agree that this is bad news for cross-references. Even with
> a "For more information, see" lead-in, not having init caps
> for titles is awkward (and the same for button and menu option
> names, imho).


Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**New Dates!!** San Francisco (Apr 16-17), San Jose (Mar 29-30) or 800-646-9989.

IPCC 01, the IEEE International Professional Communication Conference,
October 24-27, 2001 at historic La Fonda in Santa Fe, New Mexico, USA.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: Capitalization - current trends?
Next by Author: Re: Lumberg! (was Ruffled Feathers)
Previous by Thread: Re: Capitalization - current trends?
Next by Thread: Re: Capitalization - current trends?

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

Sponsored Ads