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.
Re: Screen shots within numbered steps, OR at the end?
Subject:Re: Screen shots within numbered steps, OR at the end? From:"Porrello, Leonard" <Leonard -dot- Porrello -at- TANDEM -dot- COM> Date:Wed, 29 Jul 1998 07:45:33 -0700
Would the "tutorial" and the "how to" differ? Or would the "how to" be
merely the tutorial without screen shots?
In general do "tutorial" and "how to" differ? And if so, how?
By the way, Tasha, I think the solution excellent. Here, I am looking for
clarification.
Leonard
> -----Original Message-----
> From: Benson, Tasha
> Sent: Wednesday, July 29, 1998 7:19 AM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: Re: Screen shots within numbered steps, OR at the end?
>
> I'd suggest doing it in 2 parts. Part 1 - tutorial with steps and screen
> shots. Part 2 - 'how to' with just the steps. This way, the 1st couple
> of
> times the user goes through the steps, they have everything they need to
> get
> started, and once they've done it a few times they can use the abbreviated
> version.
>
> Tasha Benson Phone: 978-551-7417
> UNIFI Communications, Inc. Fax: 978-551-7417
> 900 Chelmsford Street
> Lowell, MA 01450 <mailto:tbenson -at- unifi -dot- com>
>
> "After all, when you come right down to it, how many people speak the
> same language even when they speak the same language?" Russell Hoban
>
>
> -----Original Message-----
> From: Nickel, Joyce [mailto:jnickel -at- PAC -dot- BLUECROSS -dot- CA]
> Sent: Tuesday, July 28, 1998 1:40 PM
> To: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject: Screen shots within numbered steps, OR at the end?
>
>
> I'm writing a user manual for beginners (not techies).
> I've included screen shots within the numbered steps. The idea is to
> include the illustration along with the instructions. The problem is
> that my list of five short steps now takes three pages. The effect of a
> numbered list is kinda lost between all the illustrations. An option is
> to put all the illustrations at the end of the list. I think this would
> look more organized, but personally, I hate flipping pages to follow
> instructions.
> I appreciate any thoughts on this from the tech writing gurus out there
> . . .
> Joyce Nickel, Documentation Manager, Pacific Blue Cross, Burnaby, BC
> Jnickel -at- pac -dot- bluecross -dot- ca
>
> ~
>
>
> ~
