Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Comments on mice don't tap and tablet-users don't click: what word can I use for all audiences instead?

Parent

mice don't tap and tablet-users don't click: what word can I use for all audiences instead?

+7
−0

I am documenting features on a web site. The audience is end users, who could be anywhere from seasoned Internet veterans to relatively new people who came for my site's content but aren't generally online for hours every day. People visit the web site on a variety of devices, from phones (mobile site, touch) to tablets (desktop site, touch) to traditional computers (desktop site, mouse), and we do not plan to make documentation variants per form factor. (The site itself is responsive and follows mobile and desktop conventions as applicable.)

The documentation style is imperative, not descriptive (for clarity and to follow widespread convention). Sometimes the documentation needs to tell the user to interact with a button or link. Before mobile, we would have said "click". People reading on mobile devices know to mentally translate "click" to "tap" when reading instructions, but it makes me wonder if they are, in the back of their minds, wondering whether mobile is an afterthought for us and what else might be wrong in our documentation, so if I can find a better term I'd like to.

I considered "select", but to experienced techies that means "highlight", not "invoke". I don't know how much I should be concerned about that when writing for a general audience. (Most of my previous work has been for very technical readers and must be precise.)

Is there a general-purpose, concise term that works in imperative voice for "invoke a thing in a UI"?

History
Why does this post require attention from curators or moderators?
You might want to add some details to your flag.
Why should this post be closed?

1 comment thread

General comments (2 comments)
Post
+10
−0

I just looked up what Borland wrote in their user manual of the Turbo Pascal UI back when using a mouse was optional and the UI could be operated also by keyboard (you don't click on the keyboard either). The word they used for buttons was “choose”. For example, this is an excerpt from their manual:

This dialog box has three standard action buttons: OK, Cancel, and Help.

  • If you choose OK, the choices in the dialog box are made in the IDE.

  • If you choose Cancel, nothing changes and no action is done, but the dialog box is put away; […]

  • If you choose Help, […]

If you're using the mouse, you can click the button you want. When you're using the keyboard […]

For check boxes, radio buttons and list box entries, they used “select”.

History
Why does this post require attention from curators or moderators?
You might want to add some details to your flag.

1 comment thread

General comments (3 comments)
General comments
Monica Cellio‭ wrote about 4 years ago

Ooh, looking to the time before ubiquitous mice for hints -- nice!

Lundin‭ wrote about 4 years ago

Also these manuals were very well-written and easy to understand even for rookies, from what I remember.

dmckee‭ wrote almost 4 years ago

Everything about Turbo Pascal was good: the software, the documentation, even the license.