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.
Re: Convention for navigation labels in documentation
Subject:Re: Convention for navigation labels in documentation From:Robert Lauriston <robert -at- lauriston -dot- com> To:Ron Hearn <rhearn -at- central1 -dot- com> Date:Tue, 22 Oct 2013 13:13:51 -0700
Definitely no standard, different places I've worked have had
different conventions. I think the most common is bold.
Italic is commonly used for placeholders for strings that will vary
from one user to another.
On Tue, Oct 22, 2013 at 1:04 PM, Ron Hearn <rhearn -at- central1 -dot- com> wrote:
> Hi all,
>
> Our Product Marketing Manager asked me if there is an industry standard for the font treatment used when describing the names of labels for navigation that exists within a program. For instance, if we were to describe the following:
>
> You'll find this report in Adobe Analytics under Site Metrics > Anomaly Detection.
>
> Should bold, italics or " " marks for Site Metrics > Anomaly Detection?
>
> I generally use bold for the labels, but it would be nice to know if there is a general standard.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.