Survey paper (Part 3) Deadline: end of Friday, April 14 [ For Part 1, it is "very late" at the end of April 7. ] [ For Part 2, it is "very late" at the end of Thurs., April 13. ] [ For Part 3, it is "very late" at the end of Tues., April 18. ] ### Copyright (c) 2023 by Gene Cooperman (gene@ccs.neu.edu) ### This file may be freely copied and modified as long as ### this copyright notice remains. ### (While it is not required, it is hoped that some people will contribute ### back text or suggestions on how to improve this series, in order ### to help students and others improve their technical writing.) Please recall that if a part is "very late", then you will receive a permanent penalty of '-5' on the final survey paper. This is additive. Each part has its own potential penalty of '-5'. Also, grades on each part will be cumulative. So, if you still have only 2,500 words in your survey, you will continue to see lower grades as a reminder that this needs to be fixed. We now continue with Part 3 of good style for technical writing. Recall that the approach is to break technical writing into about five small, easy steps. You must execute these five steps for the homework in a timely many (__not__ "very late") As I promised at the beginning of the course, you should not need more than the standard 10 hours for each part (each homework), including class time. The reward is that you can assimilate and internalize these rules in a _painless_ way, that will give you a foundation for a lifetime of technical writing. --- For Part 3, you must now polish each of the individual paragraph. Within each paragraph, make sure that the stress of the previous sentence matches the topic of the next sentence. Recall that the theory behind this "algorithm" is that a reader has limited memory available when reading detailed technical concepts. We want the reader to devote that memory to the concepts, and not be distracted by matching the next phrase to a syntactical construct that appears three sentences previously. As part of polishing a paragraph, look for sentences that are too long. If a sentence is too long, this also places a stress on the reader's memory. You'll also find sometimes that it is difficult to match a previous stress with a new topic precisely when the extra phrase that you need for matching is buried in the middle of a very long sentence. As part of matching the previous stress with the next topic, you must also pay special attention to all pronouns. If a pronoun refers to the closest previous noun phrase, then it is acceptable. If a pronoun skips a phrase and refers to an earlier noun phrase, then you must replace the pronoun with a copy of the noun phrase that it refers to. And try to avoid the over-use of "we". Instead of "We showed that XXX is true.", consider "AAA shows that XXX is true." The theory is that scientists discover laws of nature that already existed. Scientists are not inventing new laws of nature. And the final rule is that you can break any of the above rules if it doesn't sound natural. By analogy, note that in standard English, the grammar rules are usually followed, but we sometimes break the rule if something seems more natural: NATURAL: "Who did you send it to?" STRICT RULES: "To whom did you send it?" A common place where authors break the rules of stress-and-topic is when they require parallel construction. In this case, the previous stress may match three topics in the three next sentences. EXAMPLE: People often ignore the rules of good style. This is illustrated by three examples. First, they have sentences that are too long. Second, it's not always obvious what a pronoun refers to. Third, they do not pay enough attention to the topic sentences in their paragraphs. === Submitting: We will continue to use markdown syntax. You can still review your writing in a familiar easy-to-read format (pdf, docs, or whatever). In hw6-surv-part1.txt, I provided standard pandoc commands to help you display your markdown in your favorite format. You will submit _only_ your Markdown (.md) file (without using 'tar'). As usual, you will submit with a submit script: /course/cs7600/homework/submit-cs7600-hw6-surv-part3 mysurvey.md