15

I'm having trouble finding and sticking to one word to indicate whatever value the user intends to use with my instructions.

For example:

Select your preferred printer.

I'm wondering what synonyms for "preferred" you would use in such a situation.

Would something more direct like "target" be more fitting? Such as:

Select the target disk.

In short, how do convey to the user that this is the time to enter preferences and not some data that they may have missed earlier?

2
  • 2
    Welcome to Writing.SE Lazarus. Please check out our tour and help center. We love questions about tech writing here; thanks for joining us.
    – Cyn
    Jun 26, 2019 at 18:09
  • 1
    the User Experience (UX) stack exchange may also be helpful. Jun 27, 2019 at 14:40

2 Answers 2

19

One possibility is to not use the adjective: "Select a printer".

Another is to use the adjective appropriate to the action: Sometimes you mean "Select a disk", sometimes (like for formatting) you mean "Select the target disk", sometimes (for installing an OS) "Select the desired boot disk", etc.

I wouldn't look for just one word. "Preferred" is sometimes valid, if we are talking about generating a report, "From the options presented, click on your preferred settings".

In that case it sounds better than "click on your target settings" or "click on the settings".

But when you are erasing files or a disk, "preferred" sounds wrong, you are taking an action on something and "target" is more appropriate: "Select the target files". Or even make it more explicit, "Select the files to be erased".

Don't feel bound by pointless consistency, your objective is to be clear to the user, you get no points for consistency of word use.

5
  • 2
    Basically any answer I'd give is one that Amadeus already covered. A preferred option isn't the same as a target one. Preferred means the default that will come up every time in the future (which you can then change). Target means the one you're going to use right now (which may or may not come up first next time, but won't be the default).
    – Cyn
    Jun 26, 2019 at 18:08
  • 2
    Besides, if my preferred printer is out of toner and torn apart to have the rollers replaced, I might need to pick a non-preferred printer if I want to get that document on paper in time for the presentation for the C-suite that's scheduled for in 10 minutes...
    – user
    Jun 26, 2019 at 18:32
  • 1
    Just as an aside "click on" is considered bad by purists. You just click, not "click on." I know this is nit-picky, but fewer words are almost always better. And don't get me started on "click and drag," which is inaccurate and wordy.
    – user8356
    Jun 27, 2019 at 20:25
  • Good reminder that I should not sacrifice conveyance for consistency. Jun 29, 2019 at 16:27
  • 1
    I like to use "select" rather than "click", "press", etc. It's more device/input method agnostic.
    – Joe
    Jul 5, 2019 at 1:02
10

All instructions writers wrestle with these terms. Just remember that instructions should be absolutely clear, without ambiguity. "Preferred" can be ambiguous. Does a "preferred" printer stay that way? Are you referring to a "preferred" printer, or just a printer to use now?

Select the printer to use (for whatever you are doing).

Avoid "desired" and similar words that imply emotional choices.

"Select the printer to use" is about as clear and concise as you can be. Most importantly, you may have to explain what a "preferred" printer means, because that's the word in the software interface or existing documentation:

"Select a printer from the Preferred Printer list. Documents will be sent to this printer unless it is not available. In that case, documents will be sent to the Secondary Printer."

When graphical user interfaces were new, there were prescribed terms: You select an object, text, or item to be the target of an action. Selection is a "ready" state. Then, you choose a menu command or click a button to apply the command to the selection.

GUIs have evolved, and newer writers don't always observe these distinctions. If you haven't done it, check out the Apple and Microsoft style guides for technical communication. And this, for all the right names of things in the Windows UI: https://docs.microsoft.com/en-us/windows/desktop/uxguide/text-ui

2
  • That is especially helpful, a large amount of the literature I have read seems to reflect when GUIs were new. I should look at the MS guide, I have been mostly following the Apple guide due to our user environment. Thank you! Jun 26, 2019 at 19:58
  • In your example, you don't even need to use "preferred". You can use "primary" and "secondary". Something like: "Select a Primary Printer from the List Of Printers To Choose From. Documents will be sent to the Primary Printer if it is available. You can also select a Secondary Printer. If the Primary Printer is unavailable and a Secondary Printer has been selected, documents will be sent to the Secondary Printer."
    – user
    Jun 27, 2019 at 7:34

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.