Tuesday 5 November 2019

Copied: Novelist Cormac McCarthy’s tips on how to write a great science paper

Article from: https://www.nature.com/articles/d41586-019-02918-5



For the past two decades, Cormac McCarthy — whose ten novels include The Road, No Country for Old Men and Blood Meridian — has provided extensive editing to numerous faculty members and postdocs at the Santa Fe Institute (SFI) in New Mexico. He has helped to edit works by scientists such as Harvard University’s first tenured female theoretical physicist, Lisa Randall, and physicist Geoffrey West, who authored the popular-science book Scale.

Van Savage, a theoretical biologist and ecologist, first met McCarthy in 2000, and they overlapped at the SFI for about four years while Savage was a graduate student and then a postdoc. Savage has received invaluable editing advice from McCarthy on several science papers published over the past 20 years. While on sabbatical at the SFI during the winter of 2018, Savage had lively weekly lunches with McCarthy. They worked to condense McCarthy’s advice to its most essential points so that it could be shared with everyone. These pieces of advice were combined with thoughts from evolutionary biologist Pamela Yeh and are presented here. McCarthy’s most important tip is to keep it simple while telling a coherent, compelling story. The following are more of McCarthy’s words of wisdom, as told by Savage and Yeh.

• Use minimalism to achieve clarity. While you are writing, ask yourself: is it possible to preserve my original message without that punctuation mark, that word, that sentence, that paragraph or that section? Remove extra words or commas whenever you can.

• Decide on your paper’s theme and two or three points you want every reader to remember. This theme and these points form the single thread that runs through your piece. The words, sentences, paragraphs and sections are the needlework that holds it together. If something isn’t needed to help the reader to understand the main theme, omit it.

• Limit each paragraph to a single message. A single sentence can be a paragraph. Each paragraph should explore that message by first asking a question and then progressing to an idea, and sometimes to an answer. It’s also perfectly fine to raise questions in a paragraph and leave them unanswered.

• Keep sentences short, simply constructed and direct. Concise, clear sentences work well for scientific explanations. Minimize clauses, compound sentences and transition words — such as ‘however’ or ‘thus’ — so that the reader can focus on the main message.

• Don’t slow the reader down. Avoid footnotes because they break the flow of thoughts and send your eyes darting back and forth while your hands are turning pages or clicking on links. Try to avoid jargon, buzzwords or overly technical language. And don’t use the same word repeatedly — it’s boring.

• Don’t over-elaborate. Only use an adjective if it’s relevant. Your paper is not a dialogue with the readers’ potential questions, so don’t go overboard anticipating them. Don’t say the same thing in three different ways in any single section. Don’t say both ‘elucidate’ and ‘elaborate’. Just choose one, or you risk that your readers will give up.

• And don’t worry too much about readers who want to find a way to argue about every tangential point and list all possible qualifications for every statement. Just enjoy writing.

• With regard to grammar, spoken language and common sense are generally better guides for a first draft than rule books. It’s more important to be understood than it is to form a grammatically perfect sentence.

• Commas denote a pause in speaking. The phrase “In contrast” at the start of a sentence needs a comma to emphasize that the sentence is distinguished from the previous one, not to distinguish the first two words of the sentence from the rest of the sentence. Speak the sentence aloud to find pauses.

• Dashes should emphasize the clauses you consider most important — without using bold or italics — and not only for defining terms. (Parentheses can present clauses more quietly and gently than commas.) Don’t lean on semicolons as a crutch to join loosely linked ideas. This only encourages bad writing. You can occasionally use contractions such as isn’t, don’t, it’s and shouldn’t. Don’t be overly formal. And don’t use exclamation marks to call attention to the significance of a point. You could say ‘surprisingly’ or ‘intriguingly’ instead, but don’t overdo it. Use these words only once or twice per paper.

• Inject questions and less-formal language to break up tone and maintain a friendly feeling. Colloquial expressions can be good for this, but they shouldn’t be too narrowly tied to a region. Similarly, use a personal tone because it can help to engage a reader. Impersonal, passive text doesn’t fool anyone into thinking you’re being objective: “Earth is the centre of this Solar System” isn’t any more objective or factual than “We are at the centre of our Solar System.”

• Choose concrete language and examples. If you must talk about arbitrary colours of an abstract sphere, it’s more gripping to speak of this sphere as a red balloon or a blue billiard ball.

• Avoid placing equations in the middle of sentences. Mathematics is not the same as English, and we shouldn’t pretend it is. To separate equations from text, you can use line breaks, white space, supplementary sections, intuitive notation and clear explanations of how to translate from assumptions to equations and back to results.

• When you think you’re done, read your work aloud to yourself or a friend. Find a good editor you can trust and who will spend real time and thought on your work. Try to make life as easy as possible for your editing friends. Number pages and double space.

• After all this, send your work to the journal editors. Try not to think about the paper until the reviewers and editors come back with their own perspectives. When this happens, it’s often useful to heed Rudyard Kipling’s advice: “Trust yourself when all men doubt you, but make allowance for their doubting too.” Change text where useful, and where not, politely explain why you’re keeping your original formulation.

• And don’t rant to editors about the Oxford comma, the correct usage of ‘significantly’ or the choice of ‘that’ versus ‘which’. Journals set their own rules for style and sections. You won’t get exceptions.

• Finally, try to write the best version of your paper: the one that you like. You can’t please an anonymous reader, but you should be able to please yourself. Your paper — you hope — is for posterity. Remember how you first read the papers that inspired you while you enjoy the process of writing your own.

When you make your writing more lively and easier to understand, people will want to invest their time in reading your work. And whether we are junior scientists or world-famous novelists, that’s what we all want, isn’t it?

This is an article from the Nature Careers Community, a place for Nature readers to share their professional experiences and advice. Guest posts are encouraged. You can get in touch with the editor at naturecareerseditor@nature.com.

Saturday 20 July 2019

Review: The Old Man and the Sea

The Old Man and the Sea The Old Man and the Sea by Ernest Hemingway
My rating: 5 of 5 stars

I heard first time about this book when my close friend Danish Gondal talked about it. He said he read it as a child, in Urdu, and it devastated him. Since then I was curious about it.

As it's a short book, and I am lagging behind my reading goal this year, so I picked up to finish it quickly. While I was reading, I was constantly telling myself to get too emotionally attached as any dark twist could come and devastate me too (Danish is a lot stronger mentally and emotionally than I am). No dark twist came. Hemingway doesn't play cheap-shots. It's not a thriller, but every bit as gripping.

It's a tale about an Old man who goes fishing. The old man is smart and humble, and poor, and skilled at fishing. And he's self-aware. He knows his weaknesses too.

I think it's a book about we we try our best to succeed in our missions, and in life, and we do too. Without giving much thoughts to the missions themselves. I think it's a novel about you have to be wise too, in addition to being clever.

View all my reviews

Wednesday 3 July 2019

Book Summary: Seven habits of highly effective people

This is a work in progress.

Summary of first 22 pages:


Character Development is the primary way of being effective. Personality Development is also important, and the lack in any of them would result in failures, Character is primary, and Personality is complementary.

Author and his wife were being bad parents because they were seeings their son's failures in life as their failures as parents. Once they realized their mistake, they accepted their child for who he was, and stopped measuring him against society's expectations. As a result, their son, who was behind academically, physically, emotionally, soared in all aspects of life.



Tuesday 25 June 2019

Review: The Master and Margarita

The Master and Margarita The Master and Margarita by Mikhail Bulgakov
My rating: 0 of 5 stars

What a beautiful book! nay, astounding! Oh it was all of it. Beautiful, astounding, gripping, enthralling. I cannot tell what it was - I can try telling what it wasn't: ordinary.

You don't know till very deep in the book who the hero is, who you're rooting for, and where the story is going to go. It talks about everything.

It's like an old but energetic, eccentric but eloquent stranger telling you a story, that is unfolding as you're hearing it, while at the same time, he starts talking about things long past, but equally interesting.

No book has ever made me want to be a cat so bad!

View all my reviews

Thursday 7 February 2019

Python progression path - From apprentice to guru


I thought the process of Python mastery went something like:
  1. Discover list comprehensions
  2. Discover generators
  3. Incorporate map, reduce, filter, iter, range, xrange often into your code
  4. Discover Decorators
  5. Write recursive functions, a lot
  6. Discover itertools and functools
  7. Read Real World Haskell (read free online)
  8. Rewrite all your old Python code with tons of higher order functions, recursion, and whatnot.
  9. Annoy your cubicle mates every time they present you with a Python class. Claim it could be "better" implemented as a dictionary plus some functions. Embrace functional programming.
  10. Rediscover the Strategy pattern and then all those things from imperative code you tried so hard to forget after Haskell.
  11. Find a balance.

https://stackoverflow.com/a/2576240/878451

Monday 21 January 2019

Review: The Complete Guide to Fasting: Heal Your Body Through Intermittent, Alternate-Day, and Extended Fasting

The Complete Guide to Fasting: Heal Your Body Through Intermittent, Alternate-Day, and Extended Fasting The Complete Guide to Fasting: Heal Your Body Through Intermittent, Alternate-Day, and Extended Fasting by Jason Fung
My rating: 5 of 5 stars

As Dr. Fung says "The proof of the pudding is in the eating."

I lost 10 kgs (22 lbs) since January 1, 2019 (that's 19 days) following the guidelines in this book.

This book was so terrific, I used to stay up till 4 am reading it.

On Dec 31, I was 60 kg overweight, now I am only 50 kg overweight. Let's see how his advice holds up in the long run. We all know, the conventional wisdom does not.

Rating it 5 stars for now. Will come back and update the review in few months. Hopefully for the better.

Currently my mother is reading it, and she has already decreased her insulin more than 25 units per day while keeping her glucose in range.

View all my reviews

Thursday 3 January 2019

Review: Apology

Apology Apology by Plato
My rating: 5 of 5 stars

Writing a review for classics is almost useless. You cannot hardly say something that hasn't been said before. However, there are those that know me, to whom my familiar and inexpert opinion may matter more than the expert review of a stranger. For those I write. And for myself, for I am among those too.

This is an elementary text for people who need to learn the basics of Philosophy, which is everyone. Socrates not only does teach us how to argue, but also how not to plead innocent. He preferred death over unrighteousness, because he made it clear he was let to live, he would continue to do the same thing.

He teaches us about the importance of doing our duty, even if the cost is death. "For wherever a man's place is, there he ought to remain in the hour of danger; he should not think of death or of anything but of disgrace. And this, O men of Athens, is a true saying"

View all my reviews