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.
> "Please arrange a session ASAP for both programmers and QC about
> abbreviating, capitalizing, punctuation, and the sort.
> As simple as it may sound, it will save us a lot of precious time.
MicroSoft Press's "The Windows Interface Guidelines for Software
Design" is a good place to look for standards. There are sections
that recommend capitalization, punctuation, etc., for the different
components in a software GUI.
It shouldn't be too overwhelming of a task to pull this information
from the book, compile a handout of a "list of rules" that you can
review in the training and everyone can take back to their desks,
and you can later put the info on the intranet or whatever avenue
your organization uses for dissemination of information.
Some may balk at using MS's standards -- whether it is for writing
user documentation or for developing interfaces. However, I have
tried to stick with these for two reasons: first, why re-invent the
wheel, and second, users are familiar with these methods.
I believe you can find much of MS's Interface Guidelines on line at
their MSDN library site.
Dana W.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Help Authoring Seminar 2003, coming soon to a city near you! Attend this
educational and affordable one-day seminar covering existing and emerging
trends in Help authoring technology. See http://www.ehelp.com/techwr-l2.
A new book on Single Sourcing has been released by William Andrew
Publishing: _Single Sourcing: Building Modular Documentation_
is now available at: http://www.williamandrew.com/titles/1491.html.
---
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.
