Martin Hing
PhD researcher
Biological Sciences, University of Wollongong
While these points may sound trivial and not worth your time, they are actually really important for your scientific writing. Reviewers will not take you seriously if your manuscript is full of basic mistakes and it puts markers of assignments in a bad mood, continuously correcting basic errors.
Genus and species names always in italics. Genus should be capitalised.
Gobiodon erythrospilus. Can be shortened after first use if it is obvious which genus you are talking about – G. erythrospilus.
Check your spelling, punctuation and grammar before submitting your assignments o Check for full stops at the end of sentences and capitalisation of first word of new sentences o Don’t go crazy with commas o Check for missing ‘and’, ‘the’, ‘a’, ‘in’ etc. o Were vs where, there vs their vs they’re etc.
Check formatting before submitting o Avoid finishing a page with a title that belongs with the paragraph on the next page o Check indenting o Check for double rows between paragraphs
Left align paragraphs. Don’t justify the text. It leaves big ‘rivers’ of space running though your paragraphs
Centre align equations and refer to them as you would a table or figure. Define any terms in your equation. e.g.:
Hamilton’s inclusive fitness theory is formalised by Hamilton’s rule which is summarized in equation (1).
rb - c > 0 -(1)
In equation (1), r is the relatedness of the actor to the recipient of the social action and b and c are the benefits in terms of reproductive success caused by the social action to the recipient and actor respectively (Grafen, 1982).
Numbers and their units should be separated by a space.
20 mm
50 o C
When referencing a table or figure, make a statement and put the reference at the end of the sentence in parentheses. For example: Fish length was correlated with age (Figure 4).
Don’t shorten ‘Figure’ to ‘fig’.
Don’t use unnecessary flowery or “sciency” language. Don’t use colloquial language either.
Be clear, concise and most of all precise. This is a difficult skill to learn and you will only pick it up by reading the literature and practicing on your own writing.
Make good use of headings and subheadings
Don’t get bogged down in the stats. Think about what the statistical results mean for the biology of the system. For example: “The interaction was significant” Doesn’t tell you much and you are just stating the obvious if you have an effects table. “The effect of copper on invertebrate communities changed significantly depending on the rate of shipping” is much more informative and relevant to the report.
Back up statements with references to the literature or statistics. If you don’t, your work is wide open to criticism.
Table 1: Commonly confused words, their descriptions and examples of how to use them correctly.
Confused words Word Description Example
Two, to , too
Affect, effect
Principal, principle
Lead, led
Two
To
Too
Affect
Effect
Principal
Principle
Lead
Number 2
As well/in excess of
Results in an effect
The result of an affect
Primary
Rule/code/theory
Heavy metal (Pb)
Two samples were excluded
Bait was used to attract animals
Too much bait might attract bigger predators
Bait choice may affect the observed species
The effect of bait choice was measured by...
The principal reason we chose...
The main principle behind the theory is...
Lead weights were used...
Accept, except
Led
Accept
Guided
Agree/believe
Except exclude
Non-significant, insignificant Non-significant P > 0.05
Then, than
Insignificant
Then
Than
Minor/unimportant
Next/at that time
There, they’re, their There
They’re
Their
Animals were led along the path
We accept the alternate hypothesis
All sites except one were included
The interaction was non-significant
Swell height was insignificant compared with tidal movement
Nestlings were removed and then returned to their original nests
This phenomenon is more common than previously considered
Introduce an idea/indicate location There is evidence to suggest...
They are They’re able reveal patterns... (usually not used in formal writing)
Belongs to them The generality of their conclusions is relatively limited
Apologies, I only have Word 2007, but the buttons should be pretty similar on newer versions. The idea of this guide is to get you thinking about the presentation of your reports. Once you know that the tools are available to you, it is up to you to find and use them.
When reading the shortcuts, “+” indicates that the keys should be pressed together and “-” indicates that keys should be pressed one at a time in a given sequence.
Superscripts and subscripts
Table 2: Good, bad and ugly examples of superscripts and subscripts. Use the same shortcut to turn off super/sub-script
Bad Ugly Shortcut
Superscript
Subscript
Good
X 2
X
1
X2
X1
X^2
X(1)
Ctrl + shift + =
Ctrl + =
Symbols
Use symbols for those statistical and mathematical Greek letters. You can insert symbols in MS Word using the shortcut: ‘alt’ – ‘i’ – ‘s’ or under the insert tab.
You will then get this window where you can select your symbol:
Table 3: Good, bad and ugly examples of mathematical characters
Good Bad Ugly
χ 2
σ 2
X2
Var()
Chi2
Sigma-squared
Mathematical equations
I don’t use these very often, but they can be quite useful.
Shortcut: ‘alt’ – ‘i’ – ‘o’ will bring up the object screen.
Scroll down and select “Microsoft equation 3.0” or whatever version it is now up to.
Table 4: Good, bad and ugly examples of mathematical equations
Good
1 n n i
1 x i
Bad
1/nΣx i
Ugly
1/n(x1+x2+...+xn)
Tables
Read some journal articles to see how tables are formatted. All tables should have the caption at the
top. Specific notes can go at the bottom. Most tables take the following format (Table 2). Only include tables for clarity. If you include a table it must be referenced in your text. Avoid redundant tables. i.e. Don’t include tables of raw data or which repeat results already shown in a figure. Don’t just copy and paste JMP output either. If you want to include an effects table you will need to only the relevant parts into the format below and include an appropriate caption.
Table 2: Example of table formatting.
Heading 1 Heading 2 Heading 3
A
B
C
D
10
20
30
40
† denotes condition 1
‡ denotes condition 2
Yes †
No ‡
Yes
No
Paragraph spacing is reduced so that caption is “attached” to the table
Superscripts can be used to add notes which appear at the bottom of the table. Note again the reduced spacing to keep everything together. Notes are often a smaller font size.
Top and bottom borders for the table and a bottom border for the heading row (often bold or double line). No column lines unless you really really really need to separate things for clarity.
I find it easiest to make tables in MS Excel and copy them into word, but you can make them in word if you wish.
Use the drop down arrow to select the table dimensions
You can turn on/off borders here
Figures
Figure captions at the bottom of the figure. Figures can be used to visualise your data or clarify methods or concepts. Graphs of your data are not statistical tests and do not ‘prove’ anything. They are just a visual representation of the data. A good rule of thumb for figures is “less is more”. i.e. take a minimalist approach. No grid lines. Remove those categories that MS Excel places on the graphs – describe your categories in the caption instead. Reference lines may be useful. eg.
Threshold lines, 1:1 correlation lines. It should be made clear in the caption what the reference line indicates and why it is relevant.
Reference line
Multiple graphs may be included in a single figure
if they are related. They should be clearly designated and referred to in the caption.
Appropriate axis labels with units of measurement
Description of categories in the caption
Note the reduced paragraph spacing to
‘attach the caption to the figure
Page breaks
Use page breaks to ensure that you don’t leave paragraph headings or figure and table captions by themselves on the next/previous page. It’s best to avoid using the ‘enter’ key multiple times to drop a heading to the next page because if you go back and add more text above you will end up with big gaps between your heading and its paragraph.
If you turn on paragraph marks you can see your page breaks and delete them if necessary.
Section breaks
Use these if you want to change the formatting of a paragraph of a whole page. For example if you have a big table which is best displayed in landscape orientation, you would click the drop down arrow on ‘Breaks’ and select ‘Next page’ from the menu, then set the next page’s orientation to landscape. You then need to section break at the end of your table and change the rest of the document back to portrait orientation. Columns can be added to a page in a similar manner by selecting the ‘Continuous’ break from the drop down menu.
If you turn on paragraph marks you can see your section breaks and delete them if necessary.
Keeping things together
Above, I’ve said to separate numbers and their units with a space. Sometimes this means that the units will drop over to the next line. To keep them together use a “nonbreaking space”.
‘ctrl’ + ‘shift’ + ‘space’. You can also use this for shortened scientific names (e.g. G. rivulatus) where the species name drops to the next line without genus letter. Nonbreaking spaces look like this ‘ o ’ if you turn on paragraph marks .
“Hard returns”, ‘shift’ + ‘enter’, can also be used to drop text to the next line without a paragraph break. I usually use this for paragraph headings. If you turn on paragraph marks, hard returns and paragraph returns look like this:
Hard return
Paragraph return
On the page, it looks like this:
Hard return – Keeps the same spacing as the paragraph, but continues on the next line.
Paragraph return – Adds a larger space and begins a new paragraph
Headers and footers
Don’t go crazy with these. For some documents it makes sense to use them for clarity but for many shorter documents they often make the page look cluttered. Page numbers are good to include, especially if you include a table of contents, but you don’t need to repeat your name and student number at the top of every page.
Headers and footers will repeat on every page unless you use section breaks and disable the “Link to
Previous” option. Double click in the top/bottom margin to open the header and footer design tab or click the header/footer buttons shown above.
If you just want a footnote at the bottom of one page, you will need to add section breaks at the top and bottom of the page and un-link the footers as above. A word of warning – This gets messy quickly if you have a lot of footnotes.
Contents tables
Mostly for big reports or theses. Learning to generate a contents table automatically will save you a lot of time. Use the styles in MS Word for headings and subheadings.
To generate the contents table:
It will look something like this, but you can fiddle with the layout:
Be sure to update the table before you print or submit.
Reviewing your work
It’s always a good idea to have someone read over your work for you. After you have read it yourself several times you become blind to a lot of small errors which a new eye will often pick up.
For self review, start with a spell check:
Word count is also a very useful tool for staying within your limits or checking word limits for certain sections.
Highlighting and making comments throughout your text is a handy method for flagging things to come back to.
To highlight text, select the text and click the highlight button. You can also select colours in the drop down menu.
To make comments, highlight the text you want to comment on and click the “New Comment” button or use the shortcut: ‘alt’ – ‘i’ – ‘m’
Learn to use it! Referencing software will keep your reference formatting consistent and automatically generate a bibliography at the end of your document. It will be slow at first, but it will save you a ton of time in the end!
EndNote is available free to students through the UoW library. The library also offers training on how to use EndNote: http://uow.libguides.com/content.php?pid=27129&sid=196631 .
There are a heap of other referencing programs available if you don’t like EndNote: https://en.wikipedia.org/wiki/Comparison_of_reference_management_software