There’s an Evil Hand Afoot and Other Ways to Spice Up Your Technical Literature

The Bulwer-Lytton Fiction Contest challenges entrants to compose the opening sentence to the worst of all possible novels. Dennis Pearce, the runner up in the 2010 Detective story category, penned the following words:

DALL-E Generated image for "there is an evil hand afoot"  How can we make technical literature more interesting?
DALL-E generated image in response to the prompt “There is an evil hand afoot”.

As Holmes, who had a nose for danger, quietly fingered the bloody knife and eyed the various body parts strewn along the dark, deserted highway, he placed his ear to the ground and, with his heart in his throat, silently mouthed to his companion, “Arm yourself, Watson, there is an evil hand afoot ahead.”

Pondering this particularly good piece of bad writing, I found myself wondering what would happen if we used this over-the-top style in tehnical literature including scientific articles and protocols. Could it help to draw attention to important details and entertain the reader at the same time? But since the goal of instructional materials is to be clear, concise and to the point, there’s not usually much room for just-for-fun content.

Or is there?

Continue reading “There’s an Evil Hand Afoot and Other Ways to Spice Up Your Technical Literature”

Use Parallel Structure to Guide the Reader

Getting What You Want from Your Science Writing Part X

computer_keyboardParallel construction signals to the reader that two ideas are of equal importance. If two or more ideas or items are connected by a coordinating conjunction such as “and”, “but” or “or”, then those ideas should be expressed in parallel or equivalent grammatical constructs. Items and ideas of equal importance should be presented using equivalent grammatical structures. Items in a list should be parallel: all verbal phrases, all nouns, etc. Parallel construction guides your reader and helps your reader organize concepts on a first read of your text. Continue reading “Use Parallel Structure to Guide the Reader”

Sloppy Technicians and the Progress of Science

Then, in 1953, a geneticist in Texas accidentally mixed the wrong liquid with HeLa and a few other cells, and it turned out to be a fortunate mistake. The chromosomes inside the cells swelled and spread out, and for the first time, scientists could see each of them clearly. —Rebecca Skloot, The Immortal Life of Henrietta Lacks

Okay, Ms. Skloot, no fair teasing a geneticist reader like that. Who was the scientist in Texas? What was the wrong liquid? How long did it take for the scientist to realize he had launched the entire field of cytogenetics with his mistake? This inquiring mind wants to know. Continue reading “Sloppy Technicians and the Progress of Science”

One Reader’s Journey through The Immortal Life of Henrietta Lacks (5)

It’s been a while since I have pre-ordered a book and waited expectantly for its arrival. Ever since reading the first reviews of The Immortal Life of Henrietta Lacks by Rebecca Skloot, I have been itching to read this book for myself.

So, when I drove home and saw the boot prints in the snow leading to the front porch, I knew the awaited tome had finally arrived. I began my journey, guided by the able pen of Skloot, through the life of Henrietta Lacks and the incredible story of her tumor cells, first introduced to me as HeLa cells when I was a college student. At that time there was virtually no acknowledgment of the fact that these cells, a staple of cell biology research and teaching, originally came from a person, a mother, a wife, a daughter.

These blog entries will not attempt to be a review of Skloot’s book; more experienced book critics have done that and done it well. Instead, here is my reaction to the book “journaled” as I read—my thoughts and questions as a scientist, a writer, a woman, a mother, a daughter, and a member of the human race.

Entry 6 March 15, 2010

Then, in 1953, a geneticist in Texas accidentally mixed the wrong liquid with HeLa and a few other cells, and it turned out to be a fortunate mistake. The chromosomes inside the cells swelled and spread out, and for the first time, scientists could see each of them clearly. —Rebecca Skloot, The Immortal Life of Henrietta Lacks

Okay, Ms. Skloot, no fair teasing a geneticist reader like that. Who was the scientist in Texas? What was the wrong liquid? How long did it take for the scientist to realize he had launched the entire field of cytogenetics with his mistake? Continue reading “One Reader’s Journey through The Immortal Life of Henrietta Lacks (5)”

Editing for Rhythm and Flow in Writing

My first project, a scarf for "Floppy Dog".

Updated 5/14/2020

For a while now I have made a living knitting words, stringing them together with a rhythm and flow to create a finished piece that has some kind of meaning. Recently I started learning how to knit yarn together with a rhythm (ideally) that will bring the loops and knots together into some kind of finished whole that has meaning: a scarf, a hat, a dish rag. And just like the clacking of knitting needles can relax and de-stress you, the clicking of the keyboard when your writing is in rhythm can be a joyful experience.

The rhythm and flow of language is important in all types of writing, including scientific writing. If your language has a consistent rhythm and flow, chances are your reader will be more likely to understand it on a first read.

Continue reading “Editing for Rhythm and Flow in Writing”

Rescue the Verb!

Getting What You Want from Your Science Writing IV: Rescue the Verb!

computer_keyboard

When I wrote for my courses in college and in graduate school, my target audience was my professor, so I wrote to impress. To sound “smart” I nominalized verbs, used passive voice and as much jargon as possible. This is the kind of writing that complex scientific topics require. Right?

Continue reading “Rescue the Verb!”

Getting What You Want from Your Science Writing Part II: Do the Math

Girl solving math problems. Science writing requires doing some math.

You may be asked to write information that involves calculations or statistics. Check and recheck your math. Consider this slogan on a bottle of grape soda:

Two liters, 50% More than One Liter!

Although it’s easy to shake our heads and lament the prevalence of such “marketing math” in our society, these errors are easy to make.

Continue reading “Getting What You Want from Your Science Writing Part II: Do the Math”

Getting What You Want from Your Science Writing: Part I

computer_keyboardGood science writing is like good writing in any discipline, the writing communicates an idea or concept to the reader in a clear fashion. The goal of the science writer is not to sound smart or elitist by using vague verbs and abstract nouns that make the reader search for meaning in the text. Instead, the goal of the science writer is to explain scientific concepts and ideas clearly and engage the reader.

Clear writing is an essential ingredient of any communication and especially scientific communication. For example, in Science, we don’t encourage clear writing, we insist on it. (Dr. Alan Leshner, [1])

Continue reading “Getting What You Want from Your Science Writing: Part I”

Accepted Without Revision

computer_keyboardScientists are as likely to feel the smart of rejection as any other kind of writer. You slave over experiments trying to make sure that they have the proper controls to account for every possible artifact. You finally head to the computer keyboard and transcribe months, sometimes years, worth of labor into a few pages of text with some figures: your opus, which you send off on a wave of electrons to some distant editorial figure. And then you wait. Continue reading “Accepted Without Revision”