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.
Jane:
I would err on the side of caution and include a comma in brackets after the
word "comma." One of our field techs suggested that I do this for
"ellipsis," and I think it was a good suggestion ["an ellipsis ( ... )
following a menu item indicates that additional sub-menus are available"].
A comma is a more common term, but still, I'd use the word and the mark --
i.e., "separated by a comma ( , )."
*************************
Jane asked:
In a manual, where name_pairs are separated by a comma, is it
appropriate to
include a comma in brackets after the word 'comma'?
Like this:
The name_pairs are separated by a comma ( , ).
Catheryn Mason, Technical Writer
Infinitec Communications
cmason -at- infinitec-com -dot- com
Winner, 1999 IABC Bronze Quill Award of Excellence for Technical Writing