Here are some general notes and instructions on how to write essays and reports.
Consider that science is always about how you express yourself and how you
contribute to an ongoing debate, very rarely insights or findings are
completely "de novo" and "ex nihilo". So, whatever you do or want to report on,
is a part of an ongoing discussion. Consequently, the presentation (and this
does not primarily refer to the layout) is extremely important.
This includes easy to understand figures, a clear and logical structure
(which itself is sort of a language people have agreed upon) and a clear and
In other words: be scholarly and remember you are always standing on the shoulders of giants!
In the following we want to give you some guidelines which should help you write reports. However, writing reports and essays is much like learning a language: you can only learn it through practise. Theoretical knowledge is helpful to get started and to reflect on your own capabilities and skills, but it can only be a guideline - not more. And, at the end of the day, there is also no point in thinking too much about it: just do it, trial and error is often your best teacher .
2.1 ABSTRACT: should be a short statement summarising the most important facts and conclusions from the work. It should spare any details and be limited to typically 150-250 words (5-10 sentences). It is not a table of contents but should explain to a potential reader why s/he should read the full article. It should briefly summarise the background, the main contents and the main conclusions.
2.2 INTRODUCTION: should start with a few easy to understand statements explaining the general context of your piece of work. It should narrow down to the specific sub-area of your work, providing a motivation for this research area. It should then be followed by references to what other people have done in the field, what the advantages and shortcomings of their insights / methods etc. The reader should gain a fair overview of what is already there and why it is worthwhile to do more research and why s/he should read on.
The Introduction should close with some few sentences providing a clear and concise statement about the outline, the aims and the objectives of this work. Ideally, you should present your working hypothesis or model which you are going to verify experimentally / computationally (research report) or through a scholarly digest of the literature (essay, project module).
2.3 (MATERIALS AND) METHODS: should describe clearly which materials and methods (chemicals, kits, machinery, algorithms, web-sites, programming language, computers etc.) you have used, why you have used them, where they were taken from and what the main underlying rationale was. Lengthy lists, e.g. of web-sites, gene names etc. should go to the appendix. The description should enable anyone who is working in the field to easily reproduce this work. If you write an essay you should briefly describe literature resources and e.g. key-words you used in PubMed or SCOPUS / Web of Science for starting your investigations and how you proceed.
Reproducibility is among the key criteria to ensure scientific credibility and to avoid scathing comments from colleagues. Some clear and well commented figures may help to illustrate the methods and thus increase comprehensibility of the paper.
2.4 RESULTS: must be clearly separated and distinguishable from hypothetical statements, speculations and generalisations. The latter should be put in the "Discussion" or, if "Results and Discussion" have been put in one section into the "Conclusions" section.
Results should be described one after the other, with a clear separation between the experiments. You should unambiguously (use labels and cross-references within the text) refer to figures which illustrate the outcome.
Figures and, where necessary, tables should be clearly labelled and commented with a figure/table caption explaining precisely what is displayed and what the symbols mean. Tables and Figures should be "self-explanatory", i.e. all labels and abbreviations used in the table itself or on the figure should be explained in the caption and an informative title should be provided for the Figure (e.g. "The frequency of missing domains across clusters classified by types of annotation artifacts and real evolutionary events"). Figures should not occur before they were mentioned in the text but ideally close to where they are referred to, i.e. shortly after.
Do not report all the detailed information such as numbers in the text, try to summarise the information in a meaningful way, avoiding unnecessary details -- and put the detailed information in the tables and Figures (see Examples).
Note: the Results section in an Essay is of course the part which describes and summarises knowledge and will fall together with the Discussion. This part will thus make up the major part of the whole essay. It can be followed then by a brief section "Conclusions and Outlook".
2.5 DISCUSSION: summarises what has been done. It emphasises the significance of the work and discusses the relationship to other works (e.g. the ones laid out in the introduction) in a fair and comprehensible manner. It may close with a short paragraph comprising speculations about the wider significance of the work and an outlook to the future. Anything that is not directly supported by your own data or that have been stated by other authors should go in here (with references!).
Furthermore, you need to address possible weak points of your approach or methodology. Conclusions and outlook is optional in a report on a project but highly recommended in an essay. Here you can, based on the discussion you have done before, express an expert's evaluation of the key points and your personal opinion about future developments.
2.6 REFERENCING:*EVERY* statement based on other's work, *EVERY* piece of text written by others must be quoted, *EVERY* method (this includes programs, databases, ...) devised by others (unless already in a text-book) *MUST* be referenced appropriately, *EVERY* piece of research you build on must be acknowledged. This means that throughout the text there appear marks such as "" or "(Smith et al 1999)" when you refer to Smith's and colleagues' work. The corresponding references must be listed at the end of the article in numerical or alphabetical order respectively or in the order they have been introduced if name-tags have been used. Throughout the text you must stick to one system and the reference list must be coherent and complete. Follow either the Harvard or the Chicago system. The minimal information given in a reference is: The name of the author (if one), both authors (if not more than two), both initials of all authors, journal name (in an approved abbreviation), volume (bold or underlined):first page, year.
Books must be listed by Author, title, "in:" Editor, book title, publisher, year and city.
Web-links are acceptable only if certain resources have not been published or to indicate the source of a download in addition to a proper reference but they do not count as a proper scientific source (and neither does Wikipedia).
It is recommended to use pybliographer under Linux (or whatever is available under windows if you happen to use MS products).
There is no guideline about an appropriate number of references: for a short report on a novel result some 10 (but certainly not less) might do, for a review up to a few hundred may be appropriate. Generally, as a rule of thumb, there will be between 20 and 70 in an original paper, some 5 - 20 in a short report and around 15 to 40 in an essay or project module report.
Naturally numbers for theses will be higher.
2.7 RESEARCH PLAN:(End of Project Module Report, MOGL Module for MSc and PhD 3 month literature- and 9 month transfer-report):
should contain a tabulated description of planed further research, structured as aims, objectives, tabulated lists of pieces of planned research with time estimates and required materials.
Tasks must be clearly linked to the literature and the discussions given before, i.e. it must be obvious and explicitly stated why steps are planned to be carried out, to which arguments given earlier on they are related to and why it is justified and necessary to perform each individual piece of work, why it is prioritised and which assumptions time estimates and required materials are based on.
3.0: You must always reference (see above) and never plagiarise (see below).
3.1 LANGUAGE: Keep it simple. Don't use sophisticated phrases. Stick to one word when you refer to one thing, i.e. avoid alternative expression. Use short sentences. If a sentence is longer than 25 words or two lines, try to break it down, even if the overall length of the text increases.
Avoid replacing nouns with "this" or "that" referring to object or subject of the previous sentence. Don't hesitate to reuse the same word repeatedly within a short stretch of text, simplicity is more relevant than aesthetics.
Virtually all scientific communication is in English. For year1 and year2 projects we do not force you to write in English. However, think if it would be for your own good? If you feel your English is miserably, start now to improve your skills and don't prolong your misery. You will not be penalised for improper use of language, grammatical mistakes etc.
Use spellcheckers (e.g. ispell), thesaurus and dictionaries and check out your style.
3.2 HOMOUR: Generally, "Funny comments", silly jokes and even irony should be omitted. First of all, what you think is funny may not be fun for others. It may confuse people, occasionally irritate them or even make them feel insulted if they don't share your sense of humour. Since you do a presentation or an essay not for yourself but for the audience (and don't forget that every report you do here should be a "simulation" of a real life situation) all that counts is how people perceive your message and not how you "meant" it.
Secondly, science must always try to be as objective as possible. Considering the rather philosophical questions about choice of subjects and the contribution to ongoing debates it should be clear that in a strict sense there is no such thing as objective science anyway. So don't make it worse. Scientific reports or essays are a serious matter and should be treated as such. Some "eye-catchers", e.g. cartoons or the like are acceptable in a presentation, e.g. when you want to convey a message or illustrate a tricky point. Still: be cautious.
Finally: way too often things come awkwardly, clumsy and this is simply unprofessional.
3.3 POLITENESS AND POLITICAL CORRECTNESS: In a workshop I organised I asked one of my PhD students to chair a session with several internationally renowned scientists. When he introduced a female speaker he said "And now it is my special pleasure to introduce the first woman ...". What was wrong? Well, first of all, it should be a "female speaker" (maybe a "lady" would be acceptable too), secondly you should consider: would you (if you are male) do the same if a man speaks next?
Think along these lines whatever you write or say about members of the opposite sex, handicapped, foreigners, etc etc. ... or simply put: about other people in general !!!
3.4 PERSONAL OPINIONS AND STATEMENTS: They, too, have no place in a scientific comment. At best you can, in the discussion section, express hopes, aspirations etc. about how your results may lead all of us to a brighter future (depending on how hard you wanna beat the drum ....).
When you explain your motivation in the introduction and, at the end of the introduction, the aims and objectives of the report are laid out, you make a fairly strong personal statement anyway. That's sufficient.
3.5 EXAMPLES of poor and better style:
|Sequence 1 had 54.234% of helices, Sequence 2 had 24.2221% helices||Sequence 1 has more helical regions than sequence 2 (Tab. 1)|
|Fig. 1: Sequences 1 and 2. See text for details.||Fig. 1: Results of structure prediction for Sequences 1 (a) and 2 (b). Blue: helical regions. Red: beta sheets. Yellow: random coil. Overal structure percentage is shown on the left.|
|Since I was asked to analyse this sequence, I clicked at the NCBI web-page and made use of their nice interface. I picked the sequence our teacher gave us on a disc and pasted it in before I hit the BLAST option. I thought the parameters as set were OK.||BLAST from the online interface at the NCBI (www.ncbi.nlm.nih.gov/entrez) was used with standard settings to search potential homologs of X against TREMBL ....|
4.1 LENGTH: See table at the end of this document.
4.2 TITLE PAGE: For easy handling of your work we ask you to staple a cover page on top of your report. All information should be given in precisely the following manner in the top right corner of the otherwise empty sheet of paper in Times Roman 14pt:
Name: A.N. Other Course: Bioinformatics 2 Immatriculation Number: 4711 Date of submission: 29.2.2005 Word count: 4200 Supervisor: Frank N. Steen Title of essay XYZ
You can get in serious trouble if you quote literally sentences from other authors or sources without explicitly using quotes and proper referencing. This may range from points deducted, failing a module, financial consequences and even ex-matriculation. And this will be implemented and it is NOT A JOKE!
|length||style||1st talk||2nd talk||3rd talk|
|Bioinf 2||2-4 p||report - paper||none||none||none|
|Project Module||6-15 p||Essay + Research plan||within 2 weeks of report submission (marked)||none||none|
|BSc report||20-60 p||Thesis||none||recommended||1-2 weeks b4 submission (marked)|
|Proj. rep. in BSc Vertiefungsmodul||6-10 p||Paper||none||none||1 week b4 submission (marked)|
|S-Kurs, MSc FM||10-20 p||Paper||optional||none||1-2 weeks b4 submission (marked)|
|MOGL MSc||10-30 p||Essay + Res. plan||after 3 months||none||none|
|MSc thesis||40-120 p||Thesis||none||recommended||1-2 weeks b4 submission (marked)|
|Bi 5||3000-5000 words||Essay||none||none||submission - 2 weeks|
|PhD litr. report||10-30 p||Essay + Res. Plan||after 3 months (marked)||none||none|
|PhD 1st year report||40-100 p||Thesis + Res. Plan||after 9 months (marked)||none||none|
|PhD thesis||70-250 p||Thesis||after 18 months (marked)||after 36 months, b4 submission||dry run|
(1) S. Becket once stated: "Ever tried. Ever failed. No matter. Try again. Fail again. Fail better." I'm not sure if this really helps. But at least it should convey the message that jumping into the cold water will, in general, still get you faster to the goal than fickling around, thinking for ages about how to do it "best" and arguing how the goals could be redefined.
Authors: Erich Bornberg-Bauer, January Weiner