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.
It's a judgement call. Here are some things that I think need to go into
making that judgment.
It has been my experience that it's a bad idea to be optimistic in
estimating how easily users will understand screen features. Murphy's Law
has never been repealed.
What's this "we" stuff? Were you part of the team that designed the
wizard? Can you personally vouch for it always working correctly? Has it
been subjected to intensive operational testing? In short, can you prove
that anyone - and I mean ANYONE - can use it correctly without
documentation?
What happens if the wizard has features that are color-dependent, where a
color-blind user may have a problem?
On Thu, May 8, 2014 at 4:47 PM, Hannah Drake <hannah -at- formulatrix -dot- com> wrote:
> Hey all,
>
> We are releasing a new wizard that walks a user through a process. The
> other person thinks the wizard should be documented for the users. My
> argument is it's redundant, because the wizard explains exactly what it is
> IN the wizard itself (I know because I wrote the text and helped design the
> wizard). I also pointed out that if we have to document the wizard, we
> failed at creating a useful wizard.
>
> The only place we currently mention the wizard in documentation is in a
> topic that talks about the various ribbon menus and what you can do on each
> ribbon, when we say: this button launches the such-and-such wizard.
>
> Thoughts? Am I wrong here?
>
> -Hannah
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp
> enhancements, and more. Read all about it.
>
> Learn more: http://bit.ly/NNcWqS
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as bus -dot- write -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications? Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public
> email archives @ http://techwr-l.com/archives
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.