web based manuals

 

Discussion

 

1. Supporting Activity: The Essentials of Technical Writing

    

 

Write a 100- to 200-word short-answer response to the following:

 

Class: Describe the dangers of complex and ambiguous technical instructions. What can you do to avoid this problem???

 

 

 

 

 

Discussion

 

1. Supporting Activity: The Essentials of Technical Writing

    

 

Write a 100- to 200-word short-answer response to the following:

 

 

 

Class: Why is it important to establish the necessary criteria before writing a manual? What criteria are frequently missing or vague in manuals? Provide an example of missing or vague criteria you have seen in a manual.??

 

 

 

 

 

1. Write a 100- to 200-word short-answer response to the following:       

 

 

 

Writing in a clear manner will do wonders for the user’s understanding. For example, this is unclear: “it is unwise to walk into the street when the red light is flashing, since it may result in a dangerous accident. It is recommended to remain on the sidewalk until the light flashes green to maintain personal safety.” Obviously, we must not cross the street when the light is flashing red, but what did the sign really tell us? This is much clearer: “Danger! Do not cross if red light is flashing.”

 

 

 

Class: how can we make our writing clear and understandable?

 

 

 

 

 

 

 

 

 

 

 

1. Write a 100- to 200-word short-answer response to the following:

 

 

 

Images can be an effective, and powerful, tool for educating an audience. Images help a reader visualize the solution, and see exactly what tasks they need to perform. Images can also help a reader avoid confusion, or misconstrue the intended outcome. However, images must clarify, and must reflect the purpose of the manual. It would make no sense to have only images of the required tools to install the faucet, rather than the faucet/process itself. This is why manuals must be clear, unambiguous and show the user a specific action.

 

 

 

Class: are there unhelpful ways/places in which to use images/illustrations in a manual? The articles articulated (very well!) the appropriate use and incorporation of images, but what are inappropriate ways in which to use images? Do you know of any examples of images that confused more than helped? Why?

 

 

 

APA format requires a concluding paragraph which sums up the wholepaper.                                                                 

 

Format your paper consistent with APA guidelines.