Re: [TCP] How would you express uncertainty in documentation?

2006-12-01 Thread Dan Goldstein
Better late than never, I came upon a user review of the Samsung SyncMaster 203B monitor, which included this comment: Despite indicating that a DVI-D cable is not included (according to Samsung's web site), to my shock I found one in the box. I'm not sure if this is a

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Jeff Hanvey
By verifying that cables are really included and stating that. I'll bet that this is a multiple-hands thing, though. The instructions were created by a technical writer in one location, the box was designed by marketing in another, and the printer was packed by an outsourced worker. The

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Dori Green
By asking those know your audience questions at the beginning -- Who will be using the instructions? What other materials go along with the instruction sheet I'm writing? How is it boxed? What is printed on the box? Show me the whole package, not just the gizmo. Dori Green Technical Writer, QMS

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Dana Worley
On Tuesday, November 28, 2006, Char James-Tanny wrote: Has anyone here purchased a printer in the last 20 years that included a cable??? I haven't...and 20 years ago (give or take) I discovered that everything included didn't include the cable, and I was not a happy camper when I had to go

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Thomas Johnson
Message- From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] On Behalf Of Beth Agnew Sent: Tuesday, November 28, 2006 4:01 PM To: tcp@techcommpros.com Subject: Re: [TCP] How would you express uncertainty in documentation? snip I liked Jeff Hanvey's solution -- a checkbox on a parts list

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Gene Kim-Eng
On a more serious note, I would just have the user manual provide instructions for installing the cable and not mention the possibility that it might or might not be there. It's more important for the information to be in the pre-sale product advertising and on the outside of the box. A totally

Re: [TCP] How would you express uncertainty in documentation?

2006-11-28 Thread Kathy Bowman
Char wrote: Has anyone here purchased a printer in the last 20 years that included a cable??? I haven't...and 20 years ago (give or take) I discovered that everything included didn't include the cable, and I was not a happy camper when I had to go back to the store. The last two digital SLR