RE: Convention for navigation labels in documentation

Subject: RE: Convention for navigation labels in documentation
From: Ron Hearn <rhearn -at- central1 -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 23 Oct 2013 09:42:35 -0700

Thanks Margaret,

I currently use emphasis styles for screen names, field labels and links/buttons etc. I just wanted to inquire whether is a standard for navigation labels on behalf of our Product Marketing Manager who was wondering if there was such a thing.

Ron Hearn
Documentation Specialist

Central 1 Credit Union
1441 Creekside Drive
Vancouver, British Columbia, Canada
V6J 4S7

rhearn -at- central1 -dot- com
Tel: 604.730.6391
Fax: 604.730-7792

-----Original Message-----
From: techwr-l-bounces+rhearn=cucbc -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+rhearn=cucbc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Margaret Cekis
Sent: Tuesday, October 22, 2013 8:36 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: FW: Convention for navigation labels in documentation

Ron Hearn asked about "Convention for navigation labels in documentation"
_________________________________________
Ron:
In systems where you can specify "Character" styles, such as FrameMaker and Word, I define an "Emphasis" style that I use for screen names, field labels, and navigation terms. I use the same font as the body text, but I make the emphasized terms bold but one font size smaller than the text font.
For example, if the text font is 12 pt Arial, I make the emphasis font 11 pt bold. It makes the label terms stand out, but has less of the "ransom note"
effect of using bold in the same font size.

My suggestion is to take a block of about 3 or 4 paragraphs of typical text from one of the applications you're documenting that has several label-type terms scattered through it, and try different font size and style combinations until you find one that looks good to you. Then put it into your templates and make it your style standard. Oh, and give the emphasis font that you decide on an easy-to-use character short cut. (I use Ctrl-e.) YMMV Margaret Cekis, Johns Creek GA



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as RHearn -at- cucbc -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
FW: Convention for navigation labels in documentation: From: Margaret Cekis

Previous by Author: RE: Convention for navigation labels in documentation
Next by Author: RE: Convention for navigation labels in documentation
Previous by Thread: FW: Convention for navigation labels in documentation
Next by Thread: OT: The state of journalism


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

Sponsored Ads


Sponsored Ads