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.
Subject:Re: Use of Optional in instructions From:Keith Hood <klhra -at- yahoo -dot- com> To:techwr-l List <techwr-l -at- lists -dot- techwr-l -dot- com>, "Bruce Megan \(ST-CO/ENG2.2\)" <Megan -dot- Bruce -at- us -dot- bosch -dot- com> Date:Fri, 11 Sep 2009 13:49:57 -0700 (PDT)
You should put the "optional" indicator at the start of the procedure step, for the same reason that you should put hazard indicators at the start: because the user needs to know what to look out for *before* he gets into doing it. When users are following a procedure they usually breeze right through - after all, they want to get the job done as quickly as possible. So they have a smooth flow of thought/action going, and they'll just keep going on mental inertia unless you interrupt the flow where necessary. If the put the "optional" indicator at the end, you'll have a lot of users who do the step and then, perhaps too late, he realizes he didn't want to do that after all. That could cause lost time and people getting angry because they have to back up and start over again, possibly having to discard work already done.
--- On Fri, 9/11/09, Bruce Megan (ST-CO/ENG2.2) <Megan -dot- Bruce -at- us -dot- bosch -dot- com> wrote:
> From: Bruce Megan (ST-CO/ENG2.2) <Megan -dot- Bruce -at- us -dot- bosch -dot- com>
> Subject: Use of Optional in instructions
> To: "techwr-l List" <techwr-l -at- lists -dot- techwr-l -dot- com>
> Date: Friday, September 11, 2009, 11:34 AM
> Hello Everyone,
>
> An interesting debate has started at my workplace... is the
> following
> use of "optional" acceptable? If not, any suggestions on
> other ways to
> 1. Select the Tx Inhibit check box, to
> block the operator from
> transmitting audio (optional).
>
> A SME has put forth the argument that a user may not catch
> the
> (optional) due to not reading the entire instruction.
>
> Your thoughts are appreciated.
> Thanks,
> Megan
>
> Bruce Megan (ST-CO/ENG2.2)
> www.boschcommunications.com
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Free Software Documentation Project Web Cast: Covers
> developing Table of
> Contents, Context IDs, and Index, as well as
> Doc-To-Help
> 2009 tips, tricks, and best practices.
>http://www.doctohelp.com/SuperPages/Webcasts/
>
> Help & Manual 5: The complete help authoring tool for
> individual
> authors and teams. Professional power, intuitive interface.
> Write
> once, publish to 8 formats. Multi-user authoring and
> version control! http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as klhra -at- yahoo -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit http://lists.techwr-l.com/mailman/options/techwr-l/klhra%40yahoo.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot-
> Visit
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices. http://www.doctohelp.com/SuperPages/Webcasts/
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-