Preferred word for “preferred”, “target”, “chosen” in end user support documentationIs there a style / terminology guide for Android OS application documentation?In end user documentation, should screenshots come before or after the text that references them?Standards for representing user interactionCan Google Docs be used for technical product documentation?Alternative word for “she”A better word for dusty?Word for a Female Teenager?Presenting documentation for a large software productWhat would be the best linking word for this context?Instruction manuals: should the end-user be addressed directly (passive vs imperative)?
Can you actually break an FPGA by programming it wrong?
What do you call a notepad used to keep a record?
How did Lefschetz do mathematics without hands?
Is Cyclic Ether oxidised by periodic acid
Copy group of files (Filename*) to backup (Filename*.bak)
Can a nowhere continuous function have a connected graph?
Are gliders susceptible to bird strikes?
I hit a pipe with a mower and now it won't turn
Most important new papers in computational complexity
Movie with Zoltar in a trailer park named Paradise and a boy playing a video game then being recruited by aliens to fight in space
Different budgets within roommate group
Warnings of R. Chaim Vital
The warming up game
How to unit test methods which using static methods?
Why is Japan trying to have a better relationship with Iran?
How can a valley surrounded by mountains be fertile and rainy?
Word ending in "-ine" for rat-like
Are all commands with an optional argument fragile?
I need help with pasta
What will happen if I checked in for another room in the same hotel, but not for the booked one?
What kind of jet plane is this?
Do home values typically rise and fall at a consistent percent?
How can I tell what kind of genitals people have without gender?
Why did NASA wet the road in front of the Space Shuttle crawler?
Preferred word for “preferred”, “target”, “chosen” in end user support documentation
Is there a style / terminology guide for Android OS application documentation?In end user documentation, should screenshots come before or after the text that references them?Standards for representing user interactionCan Google Docs be used for technical product documentation?Alternative word for “she”A better word for dusty?Word for a Female Teenager?Presenting documentation for a large software productWhat would be the best linking word for this context?Instruction manuals: should the end-user be addressed directly (passive vs imperative)?
.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty margin-bottom:0;
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?
technical-writing word-choice user-guides documentation
New contributor
add a comment |
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?
technical-writing word-choice user-guides documentation
New contributor
1
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
7 hours ago
add a comment |
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?
technical-writing word-choice user-guides documentation
New contributor
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?
technical-writing word-choice user-guides documentation
technical-writing word-choice user-guides documentation
New contributor
New contributor
edited 7 hours ago
Cyn
25.4k2 gold badges56 silver badges116 bronze badges
25.4k2 gold badges56 silver badges116 bronze badges
New contributor
asked 8 hours ago
Lazarus LongLazarus Long
333 bronze badges
333 bronze badges
New contributor
New contributor
1
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
7 hours ago
add a comment |
1
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
7 hours ago
1
1
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
7 hours ago
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
7 hours ago
add a comment |
2 Answers
2
active
oldest
votes
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.
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
7 hours ago
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...
– a CVn♦
7 hours ago
add a comment |
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
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!
– Lazarus Long
6 hours ago
add a comment |
Your Answer
StackExchange.ready(function()
var channelOptions =
tags: "".split(" "),
id: "166"
;
initTagRenderer("".split(" "), "".split(" "), channelOptions);
StackExchange.using("externalEditor", function()
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled)
StackExchange.using("snippets", function()
createEditor();
);
else
createEditor();
);
function createEditor()
StackExchange.prepareEditor(
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: false,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: null,
bindNavPrevention: true,
postfix: "",
imageUploader:
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
,
noCode: true, onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
);
);
Lazarus Long is a new contributor. Be nice, and check out our Code of Conduct.
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fwriting.stackexchange.com%2fquestions%2f46272%2fpreferred-word-for-preferred-target-chosen-in-end-user-support-documenta%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
2 Answers
2
active
oldest
votes
2 Answers
2
active
oldest
votes
active
oldest
votes
active
oldest
votes
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.
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
7 hours ago
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...
– a CVn♦
7 hours ago
add a comment |
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.
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
7 hours ago
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...
– a CVn♦
7 hours ago
add a comment |
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.
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.
answered 8 hours ago
AmadeusAmadeus
65.4k7 gold badges81 silver badges211 bronze badges
65.4k7 gold badges81 silver badges211 bronze badges
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
7 hours ago
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...
– a CVn♦
7 hours ago
add a comment |
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
7 hours ago
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...
– a CVn♦
7 hours ago
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
7 hours ago
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
7 hours ago
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...
– a CVn♦
7 hours ago
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...
– a CVn♦
7 hours ago
add a comment |
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
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!
– Lazarus Long
6 hours ago
add a comment |
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
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!
– Lazarus Long
6 hours ago
add a comment |
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
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
answered 6 hours ago
user8356user8356
3791 silver badge4 bronze badges
3791 silver badge4 bronze badges
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!
– Lazarus Long
6 hours ago
add a comment |
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!
– Lazarus Long
6 hours ago
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!
– Lazarus Long
6 hours ago
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!
– Lazarus Long
6 hours ago
add a comment |
Lazarus Long is a new contributor. Be nice, and check out our Code of Conduct.
Lazarus Long is a new contributor. Be nice, and check out our Code of Conduct.
Lazarus Long is a new contributor. Be nice, and check out our Code of Conduct.
Lazarus Long is a new contributor. Be nice, and check out our Code of Conduct.
Thanks for contributing an answer to Writing Stack Exchange!
- Please be sure to answer the question. Provide details and share your research!
But avoid …
- Asking for help, clarification, or responding to other answers.
- Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fwriting.stackexchange.com%2fquestions%2f46272%2fpreferred-word-for-preferred-target-chosen-in-end-user-support-documenta%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
1
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
7 hours ago