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.
SUMMARY: Do you include a sentence identifying the dialog name?
Subject:SUMMARY: Do you include a sentence identifying the dialog name? From:"Gilda Spitz" <gspitz -at- longview -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 8 Feb 2002 13:06:19 -0500
Thanks to everyone who responded to my little survey.
The majority of people who responded preferred to keep the status quo,
with some preferring a minor variation or two. I think we will indeed
keep the sentence as it stands.
This has been interesting. Thanks!
Gilda
__________________
>
> We've been having an interesting discussion here.
>
> Let's say we have a dialog named "Change Password". In our procedures,
> we insert a numbered step consisting of two sentences: "Choose
Database
> -> Password. The Change Password dialog appears.", followed by a
picture
> of the dialog. In the second sentence, there's an index marker for the
> dialog name.=20
>
> The discussion is this: We're thinking of ways to improve our text,
both
> to ensure the English is as good as possible, and to minimize
> translation costs. So there are several choices:
>
> * keep the status quo
> * delete the second sentence (if we did this, we'd have to move
> the index marker elsewhere)
> * change the second sentence to "The following dialog appears."
=20
>
> Just curious to see if the readers on this list have strong feelings
on
> this topic.=20
>
> Gilda Spitz
> Manager, Documentation Services
> Longview Solutions Inc.=20
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Did you know you can get RoboHelp certified?
To learn how, visit http://www.ehelp.com/techwr. Be sure to also check out
our special pricing offers and promotions for RoboHelp 2002.
---
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.
