Good writing is vital to getting credit for the work you have done. It can easily make the difference between publishing in a high impact journal and a low impact journal.
The group’s preferred tool for writing is overleaf, which is an online latex editor. Mark has a subscription for this, which allows multiple users and tracked changes if he created the initial project. Pretty much all journals accept latex these days. More likely than not, we already have a suitable template, but you can almost certainly find one on the website of the relevant journal if needed. We do use word from time-to-time, which is easy to use and has good tools for tracking changes, but is not as good at handling re-ordered text and references. For figures, we suggest the python package matplotlib.
Suggested steps for preparing a manuscript
Do not imagine that you can just write everything perfectly and then submit it after checking for typos. Almost everyone needs to revise and re-order their initial text. Writing a good paper is hard! We suggest the following sequence
- Each paper should make one, maybe two, key points. Write these down in order to focus on them and consider changing them as you tighten up exactly the best way to convey the value of your work.
- Construct the figures together with a sequence of bullet points telling the story you want to get across. Think about what order is best. Try your best to convey the overall story with the figures and captions in isolation.
- I usually like to organize the citations of the relevant literature at this point. The manuscript needs to put new discoveries made in this work front and center, while being careful to do justice to what has been done before.
- Draft the figure captions and the body of the paper describing the data. The first line of the caption should give a general sentence what the figure shows. After this, you can define the more detailed information. Tell the reader what they should pay attention to: Don’t just refer to the data and expect them to work it out for themselves.
- Draft the conclusions. Shorter is usually better here. It is often tempting to make a generic call more more experiments. Unless this invokes a particular plan or particular goal this can be very nebulous.
- The introduction is probably the hardest part of the paper to write, which is why we suggest writing it last after you are very familiar with the material in question. A good introduction starts from a general conceptual problem and logically argues that there is an important unknown question, which is the question that the paper solves. A bad introduction often just makes a case for the research field in general. For high impact journals, you will usually want to make the introduction as short as possible as this makes the work more exciting and keeps the reader focused on your data. If there is some boilerplate information you need the reader to know, it is usually best locate this in the body of the paper while discussing the data. One usually wants to avoid general literature review – keep the discussion in the context of how the manuscript goes beyond what was done previously.
- Repeat the previous steps and consider whether you can make better choices for the order of the argument, the points to emphasize and the way that the work is presented in the context of the literature.
- Do not go overboard trying to meet word or page limits in the first draft. If you write a slightly longer initial draft and then diligently revise the text, the final result will almost certain be better.
Things to check for
- Readers will often try to understand the paper by just reading the figures and captions. Go through the paper reading the captions and looking at the figure and try think whether the reader has will follow the general story.
- Remember that the audience is not a mind reader. If a sentence is a little difficult for you to parse, it will likely be missed completely by the audience. For better or worse, the onus is on you to convey your ideas even if the reader is lazy! Anyone who was read more than one or two referee reports will have seen that ideas are often missed. Try to put yourself in the shoes of a potential PhD student or a rushed reviewer.
- Be judicious about using acronyms. If the text in question is short and/or the text is only used a couple of times it is probably not worth using an acronym – it will just make the text harder to read. The main exception to this is when the acronym is unambiguous and very well known. Acronyms should, of course, always be defined in the manuscript.
- Activate voice is usually better than passive voice. Save the passive voice for special cases, such as when you want to stress the object more than the subject.
- Many students are taught that papers should be written exclusively in the third person past tense. This will make the work unbearably boring to read! Ignore this rule. In science, we are aiming for statements that are generally true: now, in the past and in the future. The simple present tense is appropriate to convey this: use it as your “go to” sentence construction. As with almost everything in English, there will be some exceptions, such as the methods section, which is often better written in past tense.
- It is best to use a variety of first, second, third person as appropriate. Try reading papers in the journal you are aiming for to get a sense of what is best.
- It is usually better to put action in verbs: “we analyzed the data” tends to be better than “we performed analysis on the data”. Some examples of verbs reformed into nouns are: regulation, analysis, occurance, understanding, investigation, deliniation, and performance. Check for these and consider replacing them.
- Short sentences are usually easier and clearer to read than long ones. Tend towards writing in short sentences and avoid sequences of many long sentences. (This is not a hard-and-fast rule.) Think of paragraph breaks in a similar way. They provide a charge to release focus on a prior idea and increase emphasis on a new idea.
- Sentences with multiple clauses or other complex constructions can be grammatical, or even beautiful, but keep in mind that you are making life hard for yourself! You are probably better off with a simple sentence.
- Multiple run on sentences with the same construction usually reflects bad or lazy writing. Excessive use of the same word can reflect the same problem ‘show’, for instance, can be often replaced by ‘feature’, ‘reveal’, ‘display’ etc.
- Be cautious about stating your data ‘clearly’ shows something. If your data are especially clear, the feature in question will leap out at the reader without special emphasis in the text. ‘Clearly’ often conveys very little and the sentence will probably be better without it.
- Take care not to make assumptions about the gender identity of researchers. The Chicago Manual of Style has a useful section about this.