TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Unfortunately, some of our field and checkbox names have lower case words in them.
>
There's nothing unfortunate about that, Mike. I like downstyle on the user interface, because otherwise it ends up having so many uppercase letters that it looks as if the page has measles.
However, this presents a dilemma: If you render the names of the controls in the manual or help text exactly the same as they appear on the interface (with lowercase initials), then you need to use an ugliness to make them stand out from the surrounding text (quotes, bold, italic, different font, underscore, whatever--not here to be picky about that). On the other horn, if you want to avoid the ransom note problem, you need to use initial caps in the text, thereby creating a situation where the words in the text do not exactly match the words on the screen (because of the difference in caps).
Here's how I resolve the dilemma (YMMV): I choose to avoid extraneous punctuation and frequent font breaks and go with the initial caps. My rationale is that text has to follow the style convention of the medium in which it appears. If I am quoting a British writer in an American publication, I transform all British punctuation and spelling to the American form (assuming I'm not writing about spelling and punctuation differences). This is normal editorial practice, just like adding or deleting the Oxford comma, abbreviating or spelling out state names, etc., to conform to the publication's stylebook. It does not constitute misquoting the author. (I might make an exception in the case of historical texts quoting original sources, but it would depend on the circumstance.)
So what I'm saying is that I trust the reader to figure out that the text transformation I apply to control names (using initial caps) does not mean I'm talking about a different button.
Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l
---
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 http://www.raycomm.com/techwhirl/ for more resources and info.
