How to write a good report
-Andy Ruina, firstname.lastname@example.org
(Created 8/2/2000 and revised 41 times, most recently on 1/9/2014)
What is good writing?
Text that convinces somebody of something.
How do you do it? Form your idea, write it badly, and then revise again and again, trying to be more and more clear.
Don't fuss over 'writing well'. Instead, try to get your message across.
|Why this essay?|
What is writing?
|Thirteen things that lots of students don't get|
|Organizing your work and time|
|A sample abstract|
|My writing gems|
I. Why this essay?
I have no natural talent for writing. I have dyslexia, bad hand-writing, bad spelling, a small vocabulary and I don't know what a past participle is. I got bad grades for writing from first grade through college. A good writer can usually edit what I write and make it smoother, shorter and more clear. So how can I, or why should I, give advice about writing?
Over the last few decades, after people stopped trying to teach me how to write, I have done some writing and I have edited even more. Through doing it and editing it I have learned a little about writing. With a million books and web pages about writing, some by real writers, there must be some that get at the things about writing that I think I've learned. But I haven't found them. The expert advice on writing seems mostly to be about more advanced things, more subtle or refined things than the basic things that I care about.
What's my main goal? Even though I knew it would take time and effort to write this, I wrote it to save me trouble. I want to avoid saying the same things to students, again and again; it is tiring to give one student after another the same tips I gave to 50 other students before. Now I can point them all here instead. With luck, now as I read student reports, I will be more happily engaged, instead of wanting to make a million edits or sending the reports back for revisions. And I will also learn more from these better-written student reports.
It's also a public service. I imagine that if someone could have somehow got the basic message of this essay (the few sentences under the title above) through the thick skull of the younger me, I would have had a better writing life, and thus a better life generally. My hope is that by spreading that message over the many paragraphs below, maybe some of the ideas will seep into some peoples' heads better. I am trying to help others get something I wish I had got earlier in my life.
My dual goal is to explain what a good report is and also how to write one. By 'good' I only mean 'good enough' or 'not too bad'. That's all I can do, all I can try to explain and all I can hope for from my students.
This is only about non-artistic practical writing; it's not about writing Haiku or songs.
II. What is a good report?
A. A report is not abstract art
I used to think that good hand-writing was ornate and flowery and beautiful to an artist's eye. But I could never make my messy scrawls smooth like that. Now I think that the most important thing about hand-writing is that it be legible. Then people can read it, which is the point. By printing slowly, I can do that. My blackboard work might look like it's written by an eight-year-old, but people can usually read it. I've gone through the same transition with my thoughts about writing. I used to think of writing as an alien thing unto itself, a kind of art to be judged by its own arty value system. So I thought that good writing used fancy words in fancy ways with metaphors, alliteration and so on. Something I can't do. But now I think that the most important aspect of writing is that it be understandable. And, using simple words I understand, I can do that! At least kind of. Now I think of both hand writing and text writing as a means to an end that is achievable.
The goal of writing is not an abstract notion of `good writing', but communication.
Conversely, I also now realize that beautiful big words written with beautiful handwriting (or great computer formatting), and even with perfect spelling, topic sentences, perfect grammar and all that, can be bad writing.
I think lots of students have the same misconception that I had about writing. They think that writing is some strange thing with a value system they don't quite get. So they have the same writing problems that I had, of trying to please some abstract writing god they can't quite see out of the upper corner of their eye, instead of just trying to say something clearly to another person. If you are one of those people, if you think that writing is making beautiful art, then here is the key: Don't think 'good writing is beautiful', instead think 'good writing is clear'.
As someone with a lifelong alienation from the humanities, seeing this functional aspect of writing is liberating. It turns writing from a foreign artistic task that I used to rebel against, into more of an engineering problem: an essay is like a computer program. The reader is like a computer; and the reader's new outlook is like the computer output. So writing is like programming and debugging. That functional view of writing makes it more straightforward and, for me, more approachable.
Just shifting the goal from style to communication is almost enough to make good writing, or at least good-enough writing. Once you make your goal saying something, rather than trying to show that you are skilled at language, you can, if you work on it enough, write tolerably. Even if you have weak language skills.
B. Write to change what is in someone else's head
Your goal is to change (to alter) your readers' minds and thus, maybe, their actions. After they have read your stuff people should know more, and maybe they should think, feel or act differently.
Some writing guides say, "Writing is communicating to an audience for a purpose." They mean that, when you write, you should keep your reader and intent in mind. This attitude comes naturally if you are pleading to get a boyfriend or girlfriend back, asking your parents for money, questioning the registrar about a bill, or complaining to a teacher about a grading policy. In those contexts you know who you are writing to and what you want. But when, instead, the explicit goal is to satisfy a teacher's demand that you write a paper, it is not so easy to focus on audience and message. So even the first step, figuring out who you are writing to and how you want to change their thoughts, is a challenge.
Here is a possibility. As a student writing about your research you want your advisor, future students and possibly readers of a technical journal to learn things from you. You want these people to be more successful when they try to pick up where you left off. Your writing should tell your readers what question you are asking, should make them interested in it, and should make them understand and believe your answer. If you succeed, they will not only learn something and enjoy being engaged, but they will also think better of you and, by association, the people around you. Your readers are probably already interested in your general problem, your goal is to teach them as much as possible about it. If their work depends on yours, it will go better because they have learned from your report.
C. How? Trial and error
The basic method is trial and error. That is, to write well you repeatedly create, test and reject.This is how biological evolution works. It is the essence of the scientific method, of problem solving, of design, of computer programming, and lots of other activities that involve discovery or creation. The only reliable way you can succeed at making good things, including good writing, is by repeatedly creating, testing and rejecting. If you are willing to try out new things, dare to check if they work, and disciplined enough to throw them out if they don't, then you have the tools to learn, discover, design ... and write. How? You write something that might be good but is more likely bad. Then you rearrange words, phrases, sentences and paragraphs. Are the new groups of words an improvement (that is, do they seem to more clearly get your message across)? If so, keep them. If not, change them or throw them out. Do this many times and then you are done.
Isn't there a better way? Here is one candidate: wake up in the middle of a dream and write down what the inspired voice is telling you. Here is another: follow the directions in The Handbook of Intelligent Design. The problem is that such inspired dreams are rare. And that handbook doesn't exist. But here is a funny thing. If you really get into the loop of figuring out what you are trying to say, and to whom, and trying to say it better and better, it sometimes gets to a point where you feel inspired. It is only after hours or days of trial and error that those rare inspired dreams sometimes do sometimes come. Finally, if there is a secret of intelligent design it is probably basically to just apply common sense trial and error again and again. Isn't there a better way? Probably not.
In summary, so far, first think about what you are trying to say and to whom. Next, try to say it. Then keep improving.
III. Thirteen things that lots of students don't get
Student reports too-often provoke some common reactions from me. Here are some.
A) Aim for content not style. Often students, instead of trying to say something, try to mimic some high-school-essay style. Why? Because they have almost no practice at communicating for a purpose. As a student it is hard to sincerely engage in an artificial task like "Write an essay to convince X of Y". For example I was once asked to write to my grandmother to convince her of the benefits of coed dorms. I couldn't pretend to care about that. So I wrote about my guess about the teacher's concept of X (my grandmother) and tried to convince that fictional person what I thought that the teacher thought about Y (coed dorms). So I tried to write in a style I thought my teacher would like, as if this was an end in itself. I feel like many students do that. Or they might try to "communicate to an audience for a purpose" in this indirect way: they try to let their teacher know that they have a poetic and creative nature so deserve a good grade. Too many students seem to pursue these perversions of the real goals of writing. Or they might not have liked the school writing game in which they pretended to have a goal that they didn't really have. So they never even tried. For some mixture of these reasons many students have almost no practice of writing for a reasonable purpose in school. Students also have little experience writing for any purpose away from school. So, when forced to write, they forget about communication and resort to chasing, with more or less sensitivity to their teachers' tastes, a style they hope will give a good grade.
But communication, not style, should be your main goal. Fancy wording that you think might please a junior-high writing teacher has a high chance of not communicating well. So it is bad writing.
What should you do? Try to give a clear message, not one with good form. In the end there might be some good style because, as the architects say, 'form follows function'. That is, if you make something function well, here that means making writing that communicates well, then good form, good style, might happen as a consequence. But if the form and style don't end up great, so what? It's the function, communication, which is your goal.
B) An affected tone is bad. Don't pretend to be someone else, and write things that you think that person knows in their style. Write what you know in your style. Faking content, or trying to be be funny, cute or grand, especially when it doesn't come naturally, will turn people off.
C) A bad first draft is O.K. Once you have some sense of what you want to say, you need to get it onto your computer. Your amorphous idea is like a lump of unformed clay you need to put on the table before you form it into pottery. Or, your collection of small ideas is like a pile of jigsaw pieces. You need to scatter them on a table before you start putting them together. So, you need to get out something, something that has in it, perhaps poorly formed or scattered, some of your ideas. It's ok if it's bad, because you are going to revise it. As Marc Raibert said, "Good writing is bad writing that was rewritten." That is, don't let worry about quality stop you from starting, you're going to fix it anyway.
C) Writing is work, mostly revising. Once you have a lump of clay on a table you then have to shape, reshape and finally glaze. That reshaping and finishing takes most of the time. Same with writing. Once you have your ideas on paper in some form, you have to change and rearrange them, and that revising takes most of the time.
Or, think of writing fragments as puzzle pieces. You have to find the pieces that belong next to each othe. You have to discover that you are putting together a different picture than you planned. You have to make new pieces that are needed for that new picture. You have to get rid of the pieces that you realize belong to some other puzzle. And you have to get rid of duplicate pieces. Throwing away irrelevant or duplicate pieces, pieces that you had carefully made (that is, text you carefully crafted), is really hard.
When I was in 8th grade my next door neighbor was Bernard Malamud, a successful writer. His wise words to me, the kid getting Cs and Ds in English, were "They say writing is 5% inspiration and 95% perspiration, but really its more like 1% and 99%." I thought he was overstating this to make a point. Like I have thought at times about "if there's a will there's a way" or "it's not what you know but who you know" or "the university is more interested in research money than in education" etc. But it turns out that `writing is mostly sweat' is one of those exaggerated sounding sayings which, despite our wanting to dismiss it as over-statement, is basically true. I didn't get it then. So maybe you won't get it now. But it's true. So the sooner you accept it the better.
D) Writing takes time. If you are talented and your paper is not for journal publication then maybe you can do with 5 revisions or so. But good papers often go through much more revision than that. And that takes time. I can type 50 words per minute. But, on average I can write and edit about one word per minute. One. For me writing is 50 times slower than typing. That is, the work of making something clear is about 50 times slower than typing it out. This is backwards from what I used to think about writing. I used to think that writing was hard because my pen and keyboard were too slow to keep up with my thoughts. Now it's the opposite, my typing doesn't slow me down at all. OK, I am older and maybe I think slower. But I don't think that's it. I think that what I used to think of as ideas that I couldn't write fast enough were probably chaotic thought fragments, topics but not coherent ideas. I was wrong to think that the slow part was, effectively, dictating to myself. The slow parts are the formulation of the ideas in your head and then refining what you have already written down.
To finish a good paper everyone, even someone who got A grades for writing all through school, needs to do lots of revising. For Malamud, for me, and probably for you, good writing comes from editing and revising. Especially rearranging words, phrases, sentences, paragraphs and sections for clarity. Then, as the writing gets better in superficial ways, you will better see that you need to change deeper things, and add new ideas. These changes will cause a new need for fixes for spelling checks and so on. This way 50 words per minute of typing leads to 1 word per minute of acceptable writing.
This may seem depressing. But it isn't. Why? Because, even if you, like me, have little talent, it means that if you put in the time you will eventually revise your initial mess into something that is good enough. Also on the plus side, slow isn't really slow. If you polish a word a minute for 40 hours a week, for 50 weeks a year, and for 50 years, you will write 6 million polished words in your life time, about 20,000 book pages, about 7 times what Shakespeare wrote. A word per minute is fast!
E) Writing is a sport. The time might pass better if you think of writing as a game. The goal is to get your reader to understand and believe you. Each small change in your text is like a move in the game. Think of a reader as a customer and that you want to sell them some knowledge. Or, think of your readers as lost sheep, wandering off unaware of where they should go. You must herd them in, reasoning from basic common broad ideas (a big field) to the central line of your argument (the gate you want them to go through). Whether you think of it as a game, a sale, or herding, the sport is trying to funnel your reader from the infinite world of alternative ideas into your line of thought.
F) Good writing is usually friendly. Tough or stern language often pokes people into fighting back. Even if you think your logic is air tight, or if your message is really a command, if you write with a pedantic, condescending or demanding tone it may make your reader rebel, stop paying attention and to miss your great explanation. For example, if you read between the lines, this essay is really a threat (to my students): "Want to get a good grade from me? Then follow the advice here!" Nonetheless, so as to not provoke, I have tried to write it with a friendly tone.
G) Get in your reader's head. What do they know and what don't they know? When reviewing things they know, you should do it clearly and concisely. That way you build trust. Then move on. When teaching them something new, you can't base it on other things they don't know yet. You can't assume they know what you are trying to say, or how it contrasts with other things you are not saying. Often students seem to be thinking "You know what I mean." in between sentences. Instead, imagine your reader is saying "I don't know what you are talking about!" after each sentence. Then write in a way that prevents that.
H) Good writing is organized. There is a conflict between structure and flow. Your organization has to deal with that.
1) Text is one dimensional, ideas are not. There is an unresolvable conflict between the linear arrangement of words on a page and the multidimensional interconnected nature of human thought. Writing is one dimensional, ideas are not. Linked hypertext is not yet an acceptable replacement for conventional linear text. This means you cannot allude to every connection between ideas at every mention of one of the ideas. To avoid tangling your linear text you often have to postpone mention of key connections. You may write one phrase about one idea, the next about a second idea, and a third about the connection between the two. Even though, in your mind, the first two ideas are meaningless without the third.
2) Put similar ideas near each other. This applies within a sentence, from one sentence to the next, from one paragraph to the next, and from one section to the next. Although you may have written your first draft with an organization in mind, you will inevitably discover a new organization during revision. As you put similar ideas near each other sentences and paragraphs will condense and congeal into larger and larger sensible units (and redundancies, things to delete, will be revealed). To put your text into order you need to work both on the small scale and the large. You have to put related words, phrases and sentences near each other. And you also have to mov whole paragraphs and maybe whole sections to keep related ideas as near to each other as possible.
3) Hierarchical structure. When you are done, a paper will have an implicit organized outline with a depth of 3 or 4 levels from sections to subsections to paragraphs to sentences. Each should have a purpose. For example, each paragraph should have a scope that you could express as a paragraph title. This paragraph title could end up being the first sentence, might end up being a low-level heading, or might be clear enough so as not to need explicit expression.
4) Logical flow. A given sentence either starts a new idea or explains more about the idea in the previous sentence. A sentence's role should be clear by the place of the sentence in the document (i.e., the lead sentence in a section), or by meaning (the sentence's content makes its role clear), or by wording (e.g., use of "furthermore", "however", "additionally"). Although structured, the paper should also flow as a logical linear stream.
5) Writing helps your thinking. It is hard to force your multidimensional ideas into a linear stream of words. But forcing ideas into an ordered sequence of words usually shows mistakes in your thinking. So you have to edit your ideas too. Although you write to share ideas you already have, writing your ideas helps you to develop them. Extruding your wide-ranging thoughts into one thin line of ordered text forces a scrutiny of them that is hard to achieve any other way. It's not just writing that is hard work, thinking is hard work. And systematic refinement of your writing forces you to think. Trying to write well about something is a tool that helps you understand your own thoughts. Most often, by trying to write clearly about an idea that is not yet clear, you sharpen your thoughts.
I) Get someone to read what you wrote. You need sincere readers, not necessarily good editors, to see what gets across. When you try an engineering design you inevitably discover pieces that jamb, circuits that overheat, and user abuse that you hadn't thought of. Most computer programs fail when first run. Similarly when someone reads your work, no matter what care you took in writing it, something won't get across to them. They will see ambiguities and paradoxes you hadn't imagined, and they will have questions that you obviously have to answer, but unfortunately didn't (yet).
Good readers of your early drafts will point out, or reveal by their misunderstandings, big problems. So it is easy to feel defeated. But that is exactly the wrong feeling to have. The bigger the flaws discovered, the more your paper will be improved. The next reader will help you find more flaws, and even flaws in your first edits. And so on. Your readers help you with one of the key parts of the evolutionary process: finding errors. Finding errors is good, because then you can fix them.
A bad first draft is fine because that lowers the threshold for starting to write. But don't give a bad first draft to your test readers. Even though you know multiple drafts are coming, you shouldn't give your test-readers something with many known flaws. That would be like testing a new machine that you know has missing pieces. When it doesn't work you don't learn much. The same with test-readers and writing. Known flaws will effectively hide the flaws you don't know about yet. The better the document you give to a test reader, the better she can find problems which you can't find, the more your document can be improved from your reader's help.
J) Hiding the truth is lying. As a rule, you shouldn't lie and deceive. Ommiting things to hide them is also deception so is generally a bad idea. Hiding by omission, conveniently not mentioning something a reader would want to know, will unfairly mislead some readers and anger others. On the other hand, being open about flaws, or about the limited scope of your work, can help build readers' confidence in you, and therefore in the results you do want to present. So, for example, if you didn't accomplish a central goal, say so prominently and clearly.
K) Credit assignment must be clear. People whose main product is information, people like professors and graduate students, are sensitive about intellectual property. To them, your presenting their ideas or diagrams, or those of other students and researchers, without proper citation, is stealing (so says Peter Woodbury -- private communication). A reader has to know which parts of the paper are original and who should get credit for the rest. Simply rephrasing someone else's paragraph, is still plagiarism. Even if you are not just being lazy by copying, but just attempting to explain something well, you will irritate people by not giving credit where it is due. But it's not just a matter of credit. Appropriate citations also give useful information about the history of the ideas and where to learn more.
An aside about extreme plagiarism. Students struggling with English often look for model sentences in papers and books. If they find sentences that serve their purposes, they might use exactly those sentences in their report. This direct copying is the most extreme form of plagiarism. It can get you expelled from school or fired from a job. As Peter Woodbury said, "If you love someone else's sentence, put it in quotations, and cite it."
L) A picture is worth a thousand words. The figures in your paper should tell your story. Even if there are just two figures, a reader should get the gist of your message by looking at just those two. As for your writing, your figures should answer the questions which would naturally come to a curious reader. And, like good writing, a figure shouldn't be a puzzle to solve, but something that explains and clarifies.
Figures, like text, inevitably need lots of revision. It is true that "A picture is worth a thousand words". But, not usually stated is the dual aspect of this. A picture is as hard to create as are a thousand words. It is not unusual to spend a couple of days, a thousand minutes, to finalize a figure.
M) Spelling, grammar, etc. Good language can't make a
bad idea good. But bad language can make a good idea useless. On one extreme,
really bad language is simply impenetrable, turning a sentence into a problem
the reader can't solve. Less extreme, but also an issue, is
the set of picky readers who know, and care too much, about the rules of writing.
Those people would rather notice that you spelled 'thier' wrong than that
what you have written, and it's right t-h-e-r-e in front of them, is the perfect
solution to their biggest problem.They're blinded by your bad spelling. Picky
fools. But, for better or worse, some of these picky fools will be your readers.
Unfortunately, even not picky readers will sometimes be distracted by bad English
Here are some of the hundreds of things that will help focus your readers attentions on your content: match a sentence's length with the complexity of the idea it expresses; use variety in vocabulary, but not by using inexact synonyms which interfere with clarity and precision; don't use SJOA (specialized jargon or acronyms); don't mix tenses or voices; and, as mentioned above, use grammar and punctuation that stay in the bounds of accepted usage. Here is a trick that catches lots of language usage errors:
read your paper out loud and make sure it sounds good to you.
But, again, don't let concern about literary style interfere with your central goal of being clear. An editor (or literate friend) can fix your bad spelling and grammar, but no-one can fix your ideas if they can't understand them.
IV. Organizing your work and time
A. The structure of a paper
Here is one way to organize a paper. Use it unless you have a better idea.
1. Title page. This page should have the title, the full author list, all details about how to reach all the authors in the near and distant future, the date of the paper and of any revisions, and the context of the paper (e.g., final report for a certain class, for submission to a certain journal, etc).
2. Abstract. This is a complete and concise summary of the whole paper. It describes the context, the results and the applications. How long? Two to ten sentences and never longer than a double-spaced page. Because an abstract optimizes completeness and accuracy in a limited space, it may be dense reading. Even a good abstract may be fully intelligible only to an expert or to someone who has already read the full paper. There's a sample abstract in item VI, below.
3. Introduction. Here you need to entice your readers. You need to bring them from what is commonly understood to the point of appreciating the questions your research answers. You introduce the ideas that led to the present work. You explain the possible applications. Keep in mind people who should be interested, but aren't yet, and what might entice them. Most importantly, you pose the questions that the rest of the paper answers. If you start with "Since the dawn of civilization mankind has always been fascinated with X." or anything that smells like that, you have missed something that I wrote above (e.g. IIA, IIIA, IIIB).
4. Methods and results. Here you describe what you did and what you found. This is the core of the paper. You may divide it into various sections as appropriate (e.g., Model Description, Experimental Method, Governing Equations, Solution Method, Results, etc.). This part of the paper should not spend too much time being philosophical, introspective or self critical.
5. Discussion. Here you discuss, critically, what you found. What are the implications? What approximations were central? What is surprising? What are possible generalizations? What natural questions does your work leave unanswered? What future work seems needed? etc. This part of the paper can, and should be, self critical.
** Note: Sections 4 & 5 above, the main presentation of your original work, might be combined into one section or divided into several sections. Whatever way you organize this central part of your report, make sure that you have enough clear headings to make your organization clear.**
6. Conclusion. The conclusion is a summary of the results. As opposed to the abstract, it does not need to summarize the methods and does not need to be as concise.
7. Acknowledgments. A relatively complete acknowledgment section shows courtesy to those who helped and funded you, and informs readers of your working environment. Usually one or two short sentences are enough.
8. Citations. A full list of the papers and texts mentioned in the paper with full reference information. It is best for each listing to include the title of the book or article, unless the target journal explicitly forbids this.
9. Figures and captions. It is easiest for the reader if the figures and captions appear in the text near where the text refers to them. Only put them all at the end if a journal demands that.
10. Appendices. Here you put details that are needed for completeness but whose complete expression would interfere with the flow of your main text. These things have a place, perhaps small, in your central argument, yet are long or complex. Also at the end you can put things you might like to keep for your records, but take too much space for a published paper. Things like computer programs, mathematical proofs, detailed graphs, work chronologies (`first I tried ...'), purchase lists, and shop drawings.
B. How should you spend your time?
1. Before you write. The initial steps.
a. Think about your message until you can say it out loud. Then do, and see if it makes sense to a friend or two.
b. Then organize the text, somehow jotting down the essential flow within and between sections. Use a short conventional outline, a few short lists, or a diagram with ideas connected by arrows (a 'concept map'). An outline that catches the essence of the structure can free you to think about the details as you write. But an outline with too high a ratio of detail to thought can feel restrictive. I find detailed outlines more intimidating than helpful. I find it easier to let the structure evolve during editing. But others think the opposite, that your organization should be clear in your mind before you start. If making a detailed outline helps you, write one. If the idea of an outline paralyzes you, keep the outline broad and vague and organize as you go.
c. After organizing as well as you can, start writing. Write in the order that feels most natural to you. You need not write in order. Start with the conclusions if that is what comes to you first. The first draft should be as complete and accurate as possible, but not concise, polished or optimally structured. As you write, allow yourself to modify the structure, especially by putting similar ideas together. But don't let revision slow your transfer of information from mind to paper too much. Attempting to get ideas onto paper while also trying to finely hone the text can be crippling.
2. Then comes revision. Even if you are a writing genius, a scientific genius, or both, you probably have to revise. A lot. You must now go through many cycles of testing, changing, adding, deleting, and reworking. Again and again, for hours and hours. Experienced writers will tell you that revision is 90% of the effort, or 95%, or 99% or more. But none will say it is 80% or less. After the uphill struggle of forming and idea and writing a first draft, revision is mostly all downhill. It's a long glide. But it is most of the trip. When you have a decent first draft you can be satisfied that you are almost done. In a way. You only have 90% (or maybe 95% or 99%) of the work to finish up.
B. What is the best report you can write?
The perfect report is perfectly clear, perfectly convincing, perfectly interesting, perfectly blah blah blah. But you don't know what that is or how to get there. What you can do is make your present draft better. You can find ways to put similar ideas closer together, to make sentences more clear, to make the central ideas more prominent, to make the text more smooth, to remove unneeded repetition, to remove unrelated ideas, etc. When you can't find a flaw, or if all attempts to fix the flaws that you have found are not improvements, then that is the best report you can write. Do you want to do better than that? Then you need to know things about writing that I don't know.
V. Final comments
My apology. As Pascal said in 1657, "I'm sorry this letter is so long. I didn't have time to write a shorter one." After at least 70 hours of writing, reading, and revising, I could still make this essay shorter, and better in other ways, by following more of my own advice. But advice is cheap. I'm a fat sloppy guy explaining how to be trim and fit. Then there all those great good suggestions for good style that are simply over my head. So they are not here.
Want more advice? After a few drafts of this essay I was pointed to this 1985 how-to guide by Marc Raibert, the guy who got me into robots. I like his tone and what he says. Here is another one, much in the spirit of this one. Here is an interesting advanced one with subtle thoughts about scientific writing, only read it if you are a native English speaker who is really into this writing thing.
A request to students. Please consider Sections III and IV.A, above, as a check list. Do your best at each element.
Thanks to Steve Collins for provoking this essay and to Rachel Ruina who's story about how to teach writing to second graders is its core. Also to Saskya van Nouhuys, Dave Nutter, Hermann and Barbara Riedel, Peter Woodbury, Steven Youra, Dirk van Nouhuys, Sidney Orlov, Rudra Pratap, Marcia Poulsen, Tomomi Ueda, Seppo Korpela, Manoj Srinivasan, Javad Hasaneini and Atif Chaudhry for criticisms and for suggested additions, deletions, and reorganization that helped make this essay little resemble its first draft.
VI. Sample abstract
Here is an abstract that Manoj Srinivasan and I wrote. We got fan mail about this from ever-critical Art Kuo, "This is perhaps the most concise, clear, and beautifully written abstract I've ever read. It's a poem. ...The success of your soda can abstract is that each sentence moved you forward, it told essentially a complete story from motivation to main finding, and it did it all in remarkably few words." I don't know what drugs he was taking, but I'd like some.
Title: Rocking and rolling: a can that appears to rock might actually
`A beer bottle or soda can on a table, when slightly tipped and released, falls to an upright position and then rocks up to a somewhat opposite tilt. Superficially this rocking motion involves a collision when the flat circular base of the container slaps the table before rocking up to the opposite tilt. A keen eye notices that the after-slap rising tilt is not generally just diametrically opposite the initial tilt but is veered to one side or the other. Cushman and Duistermaat [Regular Chaotic Dyn. 11, 31 (2006)] recently noticed such veering when a flat disk with rolling boundary conditions is dropped nearly flat. Here, we generalize these rolling disk results to arbitrary axi-symmetric bodies and to frictionless sliding. More specifically, we study motions that almost but do not quite involve a face-down collision of the round container's bottom with the tabletop. These motions involve a sudden rapid motion of the contact point around the circular base. Surprisingly, similar to the rolling disk, the net angle of motion of this contact point is nearly independent of initial conditions. This angle of turn depends simply on the geometry and mass distribution but not on the moment of inertia about the symmetry axis. We derive simple asymptotic formulas for this "angle of turn" of the contact point and check the result with numerics and with simple experiments. For tall containers (height much bigger than radius) the angle of turn is just over pi and the sudden rolling motion superficially appears as a nearly symmetric collision leading to leaning on an almost diametrically opposite point on the bottom rim.'
Of course when Manoj and I read it now, we see how to make it clearer. For example, the key idea, that what looks like a slipping collision is really an extremely fast rolling motion, isn't prominent enough. We didn't revise, and revise again, enough times!
VII. Rejects: my writing gems
Here are some fragments I worked on and, at least at some point, liked. But later when revising I thought they were redundant, off-topic, distracting or otherwise bad. So I edited them out. I really shouldn't show them to you. But I want you to see what beautiful things I threw away so you will feel better about throwing things out yourself.
Marc Raibert suggests titling a section of your paper "My Writing Gems". Then put your formerly-wonderful, but now deleted text, there. Then save that. In a private place.
My writing gets good only after I have worked on it a lot.
The main reason to write is to move a collection of facts and ideas into someone else's head.
Communication, in writing or otherwise, is transmission of information. Because your readers probably don't have extrasensory perception, writing can only convey content by having it. The quality of writing cannot transcend the quality of the information being transmitted.
This evolutionary process is sufficient, if not efficient,
Many teachers are also off track this way, having been trained in the same system. Us teachers too-often grade by an abstract image we hold of "good writing" as defined by adherence to various guidelines (spelling, grammar, topic sentences, fancy words etc.), not by success at transmitting information.
Your readers will likely pick up on whether you are writing to sound good or to get something across.
Much as we hope or pretend that they would, the exceptions to these truths don't negate their core validity. Writing just is more grinding than freeform conceptualization, both for an experienced story teller and for you and I.
The image of the talented skilled writer dashing off something lucent and concise, like puzzle pieces falling out of a box pre-assembled, is probably a fantasy twice over. First, it probably rarely happens. Second, when it does happen it probably doesn't happen. Einstein's paper on the theory of relativity is said to be great, and maybe he did not write 20 drafts of it. But I guess he worked and worked to organize the ideas in his head, not just the basic science, but how he was going to communicate his ideas. He probably had to do his 95% to 99% of perspiration, just like the rest of us. If ever there was a writer who had the talent and practice to do less editing it was the author of The Elements of Style, E. B. White. But his classic story Charlotte's Web has eight known drafts, and maybe there were more.
You should respect your reader's free will.
Your paper is a treasure map. It should tell your reader what valuable thing they can find, and it should show them how to find it.
Your opponents are all the possible other ideas out there in the universe that are not what you are trying to get across.
The repeated testing and selecting of written ideas is editing.
As William Zinsser said "The essence of writing is rewriting."
Imagine a completed jigsaw puzzle where someone left in a piece that belonged to a different puzzle!