This weeks readings, including chapters 19 and 20 from TCT, discussed the various aspects of constructing a thoroughly developed instructional document. One of the most important parts analyzed was the research that should go into creating such a document, including a solid identification and awareness of all audiences involved. An understanding of the user and the context in which the instructions will be used allow for the writer to gain a strong understanding of the writer’s perspective and speak in an appropriate, fitting tone. According to the instructor’s blog entry, this is termed the “user-centered” approach. This approach includes outlining your instructions according to the knowledge level of the user. This would include explaining certain processes or technology that the user may not be familiar with.
Chapter 20 also notes that in many instances considerations must be taken for international perspectives. This is reflected in the fact that many instructional documents seen today are written in several languages. The book states that caution must be used in translating any instructions, including contained graphics, so as to not offend individuals from different backgrounds and racial make up.
Throughout chapter 19, the importance of the user-centered approach is also emphasized, along with a lengthy explanation concerning other aspects of an instructional document’s contents. This includes an explanation of the breakdown involved in describing an actual product, including individual, major parts. Here, an emphasis is also placed on the importance of writing style, in order to make the process as simple as possible for the user.
I found the attached video to be a great illustration of well-constructed technical instructions. In this video, pertaining to the usage of Google Documents, the creator does an outstanding job of making the presentation an almost entertaining experience. A very unorthodox, unexpected approach is takes, but it works very well and isn’t overly detailed or dull. This video description also does a great job of closely following the instructional steps outlined in the readings, including beginning with some simple background information and then some powerful motivation for the product.
Concerning the ethics behind instructional documents, the instructor’s blog references several instances where obvious, and almost insulting, warnings are pasted on products. This provides some insight into the dangers of approaching the audience in a possibly offensive fashion, while still being aware of the legal issues that may come intertwined. The importance really stressed here is to take caution when constructing an instructional document and make every effort to take into consideration every possible angle.
Video instructions
I wonder who in this class has not had to put something together only to discover that the instruction booklet was obviously written in a different language and crudely translated, completely losing its effect in the process. At first, it's a good laugh. Then it is just frustrating because you're left with instructions that don't help at all.
I also found the video about google documents a good illustration for well constructed instructions. The language is simple enough and is re-inforced by pictures and moving illustrations. If only we could do this with instructions booklets that come with products.
Re: Video instructions
That google docs video was the best thing I've ever seen (in that genre). Someone had told me about google docs a few months ago and I was like, "ok...that sounds almost pointless". The video changed my mind for sure....and it was slightly reminiscent of a UPS commercial.
In response to the ethics bit:
It is sort of stupid, actually it is very stupid-what has our society come to? Spilling hot coffee on ourselves is someone else's fault? I'm torn on this argument. I want to include these sorts of warnings (like the hot coffee one) just to avoid legal ramifications, but I don't want to further this sort of idiotic attitude we seem to have adapted. Perhaps we should draw the line here and put an end to the whining...
Video Manuals
I also thought the Google Docs video was very well put together, even though it was a little childish. But in reality that’s almost perfect. It keeps them out of trouble; I can’t imagine anyone getting offended by anything in it. And with their simplicity, came great understanding. I often wonder with the internet as big as it is that there are not video manuals online. You could actually watch someone assemble whatever device you are. It seems like the next best thing to having someone actually come to your house and do it for you. Hopefully sometime in the near future this will be utilized.