Category Archives: Writing and Revising

Writing is a complicated task, so these pages will range widely: professional, psychological, scribal, rhetorical, and practical suggestions will all be here.

Novices get a say at sea level

This is a revision of “Speak up and write,” which I published here yesterday. I did not replace that essay with this one, because I wanted to show what a revision might look like. If writing is thinking, then revision is thinking even more deeply. The words on the page give you a moment, overnight in this case, to evaluate what you said yesterday. This morning I woke up aware of what I meant to say yesterday –even though I did not quite know it yesterday!.  I had become conscious of the connection between the three ideas of yesterday’s essay: Mount Everest, NASA, and of amateurs weighing in (speaking, writing, and acting) on topics of public importance. I took out my introduction (just a bridge, a comment, and not especially on point), I got rid of the tangential and probably distracting commentary on capitalism, I saw the obvious contradiction between my thoughts on the first two topics and my thoughts on the third, and I tried to figure out why it’s not a contradiction. My new draft is based on those realizations.

Writing is a form of thinking, and today I want to think about the pros and cons of expertise.

Expertise is an obvious necessity in many tasks, ancient and modern, artisanal and technical. It’s one reason that a college education, even in the United States, has become so focused and even vocationally oriented–and thus less exploratory, less experimental, less humanities-focused, and less “able to help students figure out their place in the universe and their moral obligations to fellow humans” (see Molly Worthen’s “The Anti-College is on the Rise” in today’s New York Times, 9 June 2019, for more on that). But our valuation of expertise sometimes lets us compartmentalize our participation in life too much.

First, the need for expertise. Many people were horrified recently to discover that there were crowded lines on the safety ropes to summit Mount Everest. In The Guardian’s “In Focus” podcast, “Death, carnage and chaos: a climber on his recent ascent of Everest,” (3 Jun 2019), a climber describes how people at that altitude can’t think straight, how they are each barely able to survive on the oxygen they carry, and how sick and injured climbers cannot expect to be saved by the others. They are all stuck on the same safety line, but everyone is at the end of his rope. This has always been true on Everest, of course, but now inexperienced climbers expect that their money can get them to the top. The others, in this life-or-death situation, do not always help them. Yes, there’s co-dependencies even in the best troupe of climbers, but every person must be an expert on key issues relevant to climbing mountains at high altitudes.

Now (well, as early as just next year, 2020) NASA is thinking of charging 58 million dollars (plus $35,000/day) for a trip to the International Space Station (Los Angeles Times, 7 June 2019). But I can’t help thinking of Everest. If something goes wrong–if people have to survive by their wits and what they know of space, science, and technology (think The Martian), or if there’s just a simple shortage of oxygen (think Everest 2019)–then will the “guest” astronauts survive? Even the experts with the greatest human gift of compassion will have to calculate that the survivors need to be able to, well, survive. Keeping the guests alive for another day will not solve the longer-term problem of getting the oxygen production back working, getting the ship’s communications up, getting the ship home to earth, or whatever else needs to get done. In short, sending amateurs to space is a lousy idea. Space survival requires expertise.

But life at sea level is possible for amateurs, and amateurs need to weigh in on the public debates we’re having on big issues such as economic inequality, the power of algorithms, and the climate crisis. Engineering and scientists are sometimes reticent to speak up, however, when the topic is not their area of expertise. I’ve asked ECE graduate students to read about the climate crisis, for example, and then I’ve asked them to opine. They generally won’t. They think it’s out of their area. They say they can’t evaluate all the evidence because they haven’t read it all. They say it’s a different methodology than they are familiar with. And yet, if anyone outside an Earth and Space Science Department can understand, evaluate, and appreciate the data, it’s another scientist or engineer. Also, recognizing what “scientific consensus” means might help, and there are many political, economic, and policy issues that must be discussed and then advocated for or against.

Becoming a specialist does not mean that you must voice no opinions on other topics. You are a citizen, a brainy one who asks important questions and knows how to go about answering many of them. Please, then, share your thoughts with the rest of us. Climbing Mount Everest and going to space may be the dreams of your childhood, but if you don’t have the expertise, then skip them. On the other hand, whether you understand the details or not, you can still use your voice and actions to advocate for the type of society in which you’d like to live.

Speak up and write

Writing is a form of thinking, and today I want to think about Mount Everest and NASA. Many people were horrified recently to discover that there were crowded lines on the safety ropes to summit Mount Everest. (And we readers at home, looking at the photos and hearing the stories, were probably much less horrified even than the people on the mountain, people who’d worked hard to get there, who had paid a whole lot, and whose lives were at risk because of those lines.).

We should really spend only a small proportion of our time on the consumption of media, or at least we should devote a significant amount of our attention to production. So argues Clay A. Johnson’s The Information Diet.  I completely agree, and yet I haven’t usually kept the habit. Last summer, I even gave myself I pass. I said, “I’m not going to write anything.” And I didn’t. I still gardened, cooked, came up with a new syllabus for an old class. I probably wrote a poem or two, some journal entries, some letters. There was some production, yes. But why not, this summer, try to avoid snacking on inputs so I have time for the main course, my own writing? And some of that writing will be short, snack-like, while I decide what I should really be working on!

In The Guardian’s “In Focus” podcast, “Death, carnage and chaos: a climber on his recent ascent of Everest,” (3 Jun 2019), a climber describes how people at that altitude can’t think straight, how they are each barely able to survive on the oxygen they carry, and how vulnerable and injured climbers cannot expect to be cared for by the others. They are all stuck on the same safety line, but everyone is at the end of his rope. This has always been true on Everest, of course, but now inexperienced climbers, unfit climbers, plain old (or young) rich climbers, expect that their money can get them to the top. And the others cannot always help them. Money doesn’t matter there. Everest is still free of the unctuous servility that can be bought by the winners of the capitalist game. Put another way, to support our own civility and humanity, we have to remain at the altitudes that can support life.

Now (well, as early as just next year, 2020) NASA is thinking of charging 58 million dollars (plus $35,000/day) for a trip to the International Space Station (Los Angeles Times, 7 June 2019). But I can’t help thinking of Everest. If something goes wrong–if people have to survive by their wits and what they know of space, science, and technology (think The Martian), or if there’s just a simple shortage of oxygen (think Everest 2019)–then will the “guest” astronauts survive? Even people with the greatest human gift of compassion, free of the psychology of capitalism, will have to calculate that the survivors need to be able to, well, survive. Keeping the guests alive for another day will not solve the longer-term problem of getting the oxygen production back working, getting the ship’s communications up, getting the ship home to earth, or whatever else needs to get done. In short, sending amateurs to space is a lousy idea.

That’s my big idea for the day. I wrote it down. And here’s what I think it has to do with my new and broader conception of Writineering:

Engineering and scientists are sometimes reticent to speak up when the topic is not their area of expertise. I’ve asked ECE graduate students to read a bit on the climate crisis, for example, and then I’ve asked them to opine. They generally won’t. They think it’s out of their area. And yet, if anyone outside an Earth and Space Science Department can understand, evaluate, and appreciate the data, it’s another scientist or engineer. Becoming a specialist does not mean that you must voice no opinions on other topics. You are a citizen, a brainy one who asks important questions and knows how to go about answering many of them. Please, then, share your thoughts with the rest of us. We need you to weigh in!

Introducing the hard stuff

My class this quarter has gotten used to us talking about the “topography” of any piece of writing. It seems to be a helpful word in many situations, but now I want to discuss the varying levels (or altitudes) of difficulty as one moves through the landscape of the text. Sometimes the writing is hard, and sometimes it’s got to be easy (or the reader will give up). This variation is mandatory in public science writing, but you might be kind enough to give your readers a break in your academic writing, too.

In his (public-focused but pretty difficult) 2017 book Behave: The Biology of Humans at Our Best and Worst, Robert Sapolksy writes these two paragraphs as part of the introduction to an early chapter:

This chapter is one of the book’s anchors. The brain is the final common pathway, the conduit that mediates the influences of all the distal factors to be covered in the chapters to come. What happened an hour, a decade, a million years earlier? What happened were factors that impacted the brain and the behavior it produced.

This chapter has two major challenges. The first is its god-awful length. Apologies; I’ve tried to be succinct and nontechnical, but this is foundational material that needs to be covered. Second, regardless of how nontechnical I’ve tried to be, the material can overwhelm someone with no background in neuroscience. To help with that, please wade through appendix 1 around now.

(pp. 21-2)

Notice several things here:

1. He offers “metacommentary” that communicates these messages: “What I’m about to say is important.” “This is complicated, but I’m doing my best to make it as easy and clear as possible.” “If you have not taken neuroscience, then go read Appendix 1.”

2. He offers motivating questions for this section: “how does the brain work?” and “how did the brain get the way it is?”

3. That last question is attached to the book’s overall argument in that first paragraph above: he is trying to explain all the factors that go into our behavior, factors that are immediately present and factors that happened long ago. If you’re going to make readers work hard at something, they need to know that there’s a really important reason for them to do so!

4. He uses numbers. Imagine that second paragraph without the numbers, and you will be seeing a less clear paragraph. It’s very satisfying for readers to know exactly how many ideas they are about to get, and then to tick them off. “Two. Okay: One, Two. Done!”

5. He uses the word “distal.” I probably would have avoided that. I had to look it up. It basically means “distant,” but it’s more specific to anatomy.

If you actually go read the rest of Sapolky’s book, you’ll see him describing the way that our emotional experience influences our intellectual decisions. If your readers get frustrated—especially if they think that this is more your fault than theirs—then they are going to be less likely to make positive evaluation. Their emotions, not just logic, will influence their decisions.

A book recommendation

I’ve just discovered a book by Robert Irish and Peter Eliot Weiss that I highly recommend. In fact, I intend to use it in EE 295 next year, instead of my EE 295 Sketchbook. It’s too bad that I can’t use both, but I don’t want students to have to make both purchases. I can always use some handouts from the Sketchbook and/or recommend that students borrow a copy from a friend for the quarter.

So what’s this great book: Engineering Communication: From Principles to Practice, 2nd edition.

I have not actually read the first edition, so it may not be that different, and you can get it for a few dollars (as opposed to $25-$65 for the second edition).

If you are working on improving your writing in engineering, I cannot recommend any book more than this one. More later–when I have time to tell you more about it.

Why a cow? I haven’t yet taken a picture of the book–and this is a beautiful cow!

Key words in key spots; paragraphs as musical movements

My class depends  on students bringing in and showing us models, and one student brought in “A Wideband Frequency-Shift Keying Wireless Link for Inductively Powered Medical Implants” by Maysam Ghovanloo and Khalil Najafi (IEEE Transactions on Circuits and Systems, 51.12, Dec 2004). The full title is here so you can access it yourself (I’d be happy to discuss these writers’ decisions in more detail with you), but I’ve tried to include examples of the two key features mentioned above so that you do not have to go find it yourself.

Key Words in Key Spots

Notice that the authors do not start with data and power transmission via inductive coupling alone. Since they are so intent upon biomedical implants, this idea goes into the first sentence of the introduction, too:

Screen Shot 2016-04-18 at 8.57.42 AM

Note that the sentence begins with “an inductive link” and ends with “prostheses”–both key words, and in the two prime spots in the sentence. Remember that the beginning and end of a sentence are the “prime real estate.”

And later, the first sentence of the last paragraph of the introduction reminds readers of these two important components of the article, (1) increasing bandwidth via the inductive method of FSK, and (2) using this to make biomedical prosthesis work better:

Screen Shot 2016-04-18 at 8.57.55 AM

Again, “FSK” is in one prime position, and “prostheses” is in the other.

Paragraphs as musical movements

The second and third paragraphs of the introduction are very clear, step-by-step discussions/explanations that boil down the problem to these authors’ point of attack. Here’s paragraph two:

Screen Shot 2016-04-18 at 9.19.08 AM

Notice how this paragraph moves from “need large amounts of data” to “a minimum of 625-1000 pixels” to specific numbers of bits in the stimulation commands, to how many bits per command frame, to  how many of those there are, to one piece of good news about lowering the required data rate, to the obvious conclusion that a high data rate is needed. It’s like the paragraph is reaching a crescendo in a musical piece, with one softening part near the end, and then a loud, loud final sentence.

Paragraph 3 does something similar with the data rates that have been achieved so far, although the data rate seems to be getting softer/lower as we add the costs/trade-offs, and then it ends with a strong determination to do better/the goal:

Screen Shot 2016-04-18 at 9.20.34 AM

If you are a musician, or if you just like to listen to music, then thinking about paragraphs as short movements in a musical composition might help you structure them so that they come across more powerfully.

An addition, to underline the importance of key words in key spots:

The American Scholar has a list of what it calls “the ten best sentences.” Here’s one, with the reasons that Roy Peter Clark gave for why it’s great:

Anger was washed away in the river along with any obligation.—Ernest Hemingway, “A Farewell to Arms”

Donald Murray used to preach the 2-3-1 rule of emphasis.  Place the least emphatic words in the middle.  The second most important go at the beginning.  The most important nails the meaning at the end.  Hemingway offers a version of that here. A metaphor of flowing water is framed by two abstractions Anger and Obligation.  That fact that the metaphor is drawn from the action of the narrative makes it more effective.

Long names/nouns are easy to write but difficult to understand

First, a definition. A “noun phrase” is not the entire subject of a sentence. Your sentence might be

The brave, warmly dressed woman holding a saw and the large hawk with a rat in its mouth perch in the tree staring at each other.”

Then the subject has two noun phrases in it. It’s a collection of nouns and adjectives (or even phrases) that have been stuck together to form one long noun. Some other examples are:

power-controlled rate-adaptation interference graph and

wideband, high-resolution analog-to-digital converter.

Here are two places to find more examples: http://www.chompchomp.com/terms/nounphrase.htm and http://www.grammar-monster.com/glossary/noun_phrases.htm.

The common technique in engineering is to stick everything together in one set of adjectives and nouns, and then skip the (helpful, sometimes more explanatory) prepositional phrases. I often want you to unpack the set of adjectives and nouns and use phrases to clarify what you mean. Also, you might discover that you don’t need all that information about the noun; you might already have established this information earlier in the article, and you can just use a shorter name for this thing.

 Here’s example that a student brought in last week:

Understanding spin transport via collective magnetic excitations is currently gaining attention.

This is a refreshingly short sentence, but it’s a bit difficult to unpack (by which I mean, “interpret”). In other words, the reader has to turn the words around in his or her head in order to understand what it means. Here are some possible revisions:

Researchers are now trying to use collective magnetic excitations to understand spin transport.

Researchers are trying to understand spin transport by looking at collective magnetic excitations.

Researchers are trying to understand spin transport by looking at the way that collective magnetic excitations influence them.

But maybe none of these is  accurate. They might not be what the sentence means at all. I had to make up some possible relationships between the two topics, which would not have been necessary if the writer had clarified that relationship. Often, when I quiz students on what they mean by a sentence, we go though many revisions together before I suddenly realize what they meant, and how far that was from my guess!

Take-away message: beware the long noun phrase. If you find yourself writing one, determine if there’s some information in it that has already been clearly established; then take that part out. If it’s still ambiguous or just hard to figure out, explain the relationship between the various parts of the noun phrase.

Anything you can do to make your reader’s job easier will help assure that they are getting the message you intend to send. It will also get you more readers!

 

Drama in an EE paper

I will first not-completely-but-somewhat-jokingly say that this article’s first author is a past student of EE 295, so of course he’d be doing lovely things with his writing! (I will add that he was a good writer when he started in EE 295, and that his advisor’s students are often excellent writers. The advisor is the third author on this paper. A culture of good writing, of valuing writing, seems to develop in some labs.)

This July 2015 article is “Variable-Length Convolutional Coding for Short Blocklengths With Decision Feedback” by Adam R. Williamson, Tsung-Yi Chen, and Richard D. Wesel. Since it is so recent, I will only photograph one short excerpt from the text, although somewhat more will be cited and described.

Drama is developed from the first sentence, when the authors write something along the lines, of “Although the founding father of our field found that feedback was not useful for x, feedback can be used for other purposes”:

Screen Shot 2015-10-27 at 2.10.30 PM

If that’s not dramatic, then what is? It’s dramatic when an important figure in the field is right, or wrong, or just missed noticing something important.

The way that Einstein’s thoughts on the cosmological constant have been cited and argued for and against is perhaps similar. He was right. He was wrong. (Maybe there we even some other back-and-forths, and certainly there were many amendments.) Then, a January 2013 Scientific American called “Right Again, Einstein!” starts, “A new study of one of the universe’s fundamental constants casts doubt on a popular theory of dark energy” (Moskowitz). Almost three years later (Sept 2015), “What Einstein Got Wrong” in that same magazine begins: “Like all people, Albert Einstein made mistakes, and like many physicists he sometimes published them” (Krauss). There’s something exciting and important about great thinkers having limitations, even if they might just be limitations caused by the moment of time in which they lived, and the development of their fields at that moment.

The extensive literature review of the Williamson et al. paper tells a story, too. It’s chronological: this idea was developed, and then that, and then this other one went further. It’s also got characters; the researchers are listed by their names, rather than the papers being listed by reference numbers. Once there are names, some intellectual drama can be introduced: all these authors did stuff in reaction to the work that came before: one name does “pioneering work,” another “formalizes it” or “demonstrates” something else, or “furthers” or “extends” the work. Others “study” or “show” or “provide an overview.” It’s complicated, but there are a lot of people doing stuff, cooperating even, and that’s interesting and appealing.

Close Reading Gabor

If you bought the EE 295 Sketchbook, then you can (if you choose) review topics such as the types of sentences (simple, compound, complex, and compound complex), the ways good paragraphs are put together (with thesis or topic sentences, moving from simpler sentences to more complex ones and then back, and with coherence), and even the ways that sentences can be written to connect to one another helpfully within paragraphs (“connectivity”). Reading for the authors’ rhetorical choices is a new way of seeing, but I think it’s one of the most useful skills to improve your writing over your whole career.

One other thing to take into account, since we’ll be looking at introductory paragraphs, is that the beginning of a journal article tends to establish common ground, state a problem, and explain the writer’s response.

With all that in mind, let’s look at some examples from journal articles in the field.

Gabor’s classic article, “The Theory of Communication” (1946), starts like this:

Screen Shot 2015-10-11 at 4.11.43 PM

Notice, of course, how the very first paragraph is straightforward: “the purpose of this study” and the organization of the article are immediately specified. The first sentence is long, but it is just a simple sentence: the purpose is to present a method. All the rest are added phrases. The second sentence is complex, but it’s not a difficult one to figure out. There’s a dependent clause (starting with “while”) and then the main, independent clause.

The second paragraph then moves to one of the main goals of any introduction: establishing common ground. But what else does Gabor achieve here? The paragraph reads as as a short, short review article. This works to establish the writer’s authority. And it’s orderly; it’s a chronological story of how one idea develops off of another. After the first sentence or two, every other one begins with a time period. Usually the main subject is the researcher. Then there are specific and varied verbs: “disproved,” “discovered,” generalized.”

And let me emphasize that it’s a story, a narrative, which is an easy way for readers to process information. The engineers become characters in this story, which make the story easier to understand than if the subjects of the sentences were the inanimate “principles,” “claims,” and “convictions.”

Notice that the first two sentences do start with these inanimate subjects, and this is probably to establish the subject of the whole paragraph: principles of transmission. Notice, too, that the paragraph ends with these words, too; the final sentence contains both “transmitted” and “transmission.” It’s hard to get too far off track when reading this paragraph.

I’ll look at other paragraphs from other articles in future posts.

Remembering what drives you

You might just want to write about your work, but I recommend backing up a bit and writing some preliminary thoughts. What is your story? How did you get interested in this work? What excited you when you were a child or early in your school years? What was difficult for you to understand, and how did you figure it out?

If you want to get other people interested in your work, you need to express your own enthusiasm for it, but if you are an advanced graduate student (that is, narrowly focused, thinly stretched, over-directed, or just tired) then perhaps you’ve lost your way. You might have let your initial excitement about science or your particular field drown in the details of everyday life. You might even have become cynical.

Writing about your memories is good practice for many things: detailed sensory description, communicating with a lay-audience (outside your field), thinking about your own field from a different perspective, remembering what you used to think when you were outside your field, etc. It will also remind you of your early values and goals and dreams and excitement.

If you are interested in what inspired other scientists, then you might read Curious Minds: How a Child Becomes a Scientist, edited by John Brockman.

And if you are having real trouble feeling connected to your work, perhaps because your lab is full of people who seem to have forgotten their initial enthusiasms, start asking questions. How did they get into the field? What was their education like? What was exciting to them? What did they most love about engineering or science when they were 10 or 15 or 20 years old? These memories can bring you together, re-motivate more than just you, and also help you start to remember what it was like NOT to know what you now know. Remembering that will help you be a better teacher and communicator to an audience with varying levels of expertise.

Learn to Write by . . . Writing

Writers need to write. And writing to yourself is a good place to start. Take notes, jot down ideas, and keep detailed records of what you’ve done or plan to do in your research project. This way you are using your writing to help you think, not just writing to summarize what you already did and thought. In other words, you can use writing to discover what you have to say. This discovery is one of the fun parts of writing; I think that it’s boring to write down what I already know.

If you keep notes as you go along, you will be able to remember your own process of coming to know this new information; these notes should help you figure out how to explain your findings to people who do not yet know what you’ve already found out.

When you have to write about your project more formally, no matter what the format, you have something more than hindsight to work with. You can paste together what you’ve already written, and then revise it. It’s much easier to write when you have some words on the page, talking back to you, telling you what’s missing or what could be clearer. Writers produce dozens of drafts of any good text they produce. If you are reluctant writer, you might not be as eager to do write all those drafts, but think of the efficiency of working from pieces you’ve already written!

Some of your best ideas—for writing and for everything else– will occur to you when you are falling asleep, walking to class, or standing in line somewhere. Jot these down. Then when you actually have to sit down at your task and produce a draft, or the next draft, you will have something to start with. Respect your random ideas—comparisons, phrases, connections–enough to scribble them down, and you will find it much easier to begin writing.

You won’t know what your choices are until you draft a few different versions of any text, until you experiment. Your decisions will tend to fall in a range between two opposites: predictability and surprise, complexity and simplicity, clarity and confusion, explaining and expecting your reader to know. Many other binary opposites could go here, but you probably get the idea. You can fondly look after your readers, or you can disrespect them and be demanding of them. Guess what works better.

Try to make a plan for yourself. Start by writing x mins/day or y hours/week.