1. h32.1 15-Mar-01 Clark Thomborson Software Security CompSci 725 Handout 39: Report Writing #3 Clark Thomborson University of Auckland

2. h32.2 15-Mar-01 Clark Thomborson Woodfords 25 Steps (reduced to 18) 1.Decide on a topic (Woodfords Step 2) 2.Write the title & synopsis (Woodfords Step 5) 3.Review requirements (Woodfords Step 6 & 7) http://www.cs.auckland.ac.nz/compsci725fc/lectures/handout12.pps 4.Decide on the basic form of the article This is Woodfords Step 8. Read Eisenberg pp. 39-40, 46-51 (Handout 22) 5.… (see Woodford excerpts in Handout 22)

3. h32.3 15-Mar-01 Clark Thomborson Logical Communiation [Eisenberg, 1989] Communication that is logical is reasoned in the –proposition [the subject to be discussed, or statement to be upheld], –order [placement contributing to the force and beauty of expression, or to the clear illustration of the subject], –interconnection [mutual union], –development [unfolding, advancing], and –disposition [order, method, distribution, arrangement] of its elements. It is the first, most urgent job of the [technical] writer to make the logic apparent.

4. h32.4 15-Mar-01 Clark Thomborson The Murder Mystery In a well-written murder mystery novel, the reader is in suspense until the last page. In suspense means held in doubt and expectation. Dont write a technical report that keeps your reader in suspense until the last page. Few readers will be patient enough to read a mysterious report. When you write as a technical professional, your reader needs first and foremost to understand the structure or path of your argument.

5. h32.5 15-Mar-01 Clark Thomborson Comparison and Contrast Format The topic sentence of a comparison and contrast paper, section or paragraph should set forth alternatives for doing something (e.g. growing crystals). Each section of a comparison and contrast paper should discuss the similarities (comparisons) and differences (contrasts) in the alternative methods. The first and last sections should give an overview. The middle sections should each discuss different points of comparison or contrast. For example, the section on Preparing a Saturated Solution contrasts the two methods. Another section, on Preparing a Seed Crystal discusses a similarity.

6. h32.6 15-Mar-01 Clark Thomborson Problem – Solution Format First, state the problem – what is the question being answered by your paper? Next, outline a solution – how the problem can be solved. –In this section you might describe how to start solving the problem, in which case youre writing in research proposal format. Be sure to discuss other peoples work on this problem, critically & appreciatively, before you give details of your proposal. Give applications or examples of your solution. End your paper with a critical & appreciative analysis. –Is the problem adequately solved in all contexts? –What similar questions might be answered by similar answers?

7. h32.7 15-Mar-01 Clark Thomborson Main Idea – Significance Format First, explain what – your central idea. Next, explain so what – why should anyone care about your idea? Now that you have the readers interest, you can discuss the details. Define your terms carefully, and explain their relationships in a way that illuminates your idea.

8. h32.8 15-Mar-01 Clark Thomborson Woodfords Form 1.Introduction 2.Materials and Methods 3.Results 4.Discussion This is suitable for any experimental study. Question: Which of Eisenbergs formats is the best match to Woodwards form?