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.
When I documented a touch-screen program, I simply used the word "select"
(select Delete), so they could use the button on the screen or the keyboard
if it applied.
Melissa
----- Original Message -----
From: "Balchunas, John" <JBalchunas -at- orgtek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Sent: Tuesday, March 13, 2001 9:24 AM
Subject: Documenting a Touch-Screen Interface
> Hey everyone,
>
> Anyone have any experience documenting touch-screen interfaces?
>
> My department is soon to begin a large-scale revision of one of our
operator
> manuals for a product which has a touch-screen interface. The original
> author of the manual inserted Microsoft Drawing Objects into the text when
> referring to a touch screen button. I have crudely attempted to
illustrate
> the result using plain text below (if you can imagine basically a shaded
> text box around Probe Priming Menu with extra space above to accommodate
the
> box):
>
> | |
> 7. Touch | Probe Priming Menu |. The following window appears.
>
>
> In my opinion, this takes up a lot of wasted space (if you add up the
extra
> space above required for each button over the course of an entire manual
it
> probably increases the overall page count by 25-30%).
>
> Any thoughts as to how to refer to/indicate touch-screen buttons. I have
> considered something as simple as placing the button text in
> bold/small-capped font with brackets around it. Something along the lines
> of what follows (if you can imagine small caps/bold for Probe Priming
Menu):
>
> 7. Touch [Probe Priming Menu]. The following window appears.
>
> Anyway, any thoughts as to how to refer to touch-screen buttons?
>
> Any insight would be appreciated...
>
> Thanks,
>
> John Balchunas
> Technical Writer I, Labeling and Packaging Development
> Organon Teknika Corporation
> 100 Akzo Avenue
> Durham, NC 27712
> tel. 919.620.2053
> fax: 919.620.4170
> email: jbalchunas -at- orgtek -dot- com <mailto:jbalchunas -at- orgtek -dot- com>
IPCC 01, the IEEE International Professional Communication Conference,
October 24-27, 2001 at historic La Fonda in Santa Fe, New Mexico, USA.
CALL FOR PAPERS OPEN UNTIL MARCH 15. http://ieeepcs.org/2001/
---
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.