How To Write A Good Report: Tomas Maul
How To Write A Good Report: Tomas Maul
How To Write A Good Report: Tomas Maul
a Good Report
Tomas Maul
This talk is based on slides by Khalid Al
Murrani and Michel Bister
Preface
Without
Work,
finish, publish
(Michael Faraday)
Structure
Front
matters
Title:
Author(s) & affiliation:
Abstract:
Acknowledgements:
(Table of Contents)
(List of Tables)
(List of Figures)
What is this?
Who wrote this?
Summary of the work
Who helped?
Structure
Body
of the report
Introduction:
about?
Method:
Results:
Discussion:
Conclusions:
remembered?
Structure
End
matters
References:
to?
Appendices:
Extra information
Title
Short
Accurate
Informative
Include
key-words
No
abbreviations
Abstract
Summary
of work
Should be self-contained (no references)
1-2 sentences for each of the 5 main parts
(introduction, method, results, discussion,
conclusions) then streamline
High information content
Abstract
No
abbreviations
200-300 words
Best (re-)written last
All information should be covered in the body
of the report
Introduction
Usually
too long
Best written last (or at least rewritten). The
work it requires (e.g. background reading)
needs to be done first.
Provides background information
Tries
Introduction
Places
paper in context
Defines
10
Introduction
Shows
before
= literature review
Refer to main authors/works in the field (most
relevant work)
Refer to most recent work in the field (use Citation
Index)
11
Introduction
Shows
12
Method
What
13
Method
Mention
14
Results
Purely
objective
Only facts and observations
No opinions or interpretations!
Text
15
Results
Figures
Label
all axes
Mention all units
Use same scaling for figures that need to be
compared
Put caption BELOW the figure
Number the figures sequentially
Include the figure immediately after the first
reference to it in the text (unless page layout
does not permit)
Khalid Al Murrani, "How to Write a Good Report",
2008-09
16
Results
Figures
Put
17
Results
Tables
Label
all columns
Mention all units
Put caption ABOVE the table
Number the tables sequentially
Include the table immediately after the first
reference to it in the text (unless page layout
does not permit)
18
Results
Use
19
Discussion
Only
20
Discussion
Differences
results
Possible explanations for differences/
discrepancies
Point out potential shortcomings
Recommendations for future work
Theoretical implications
Possible applications
Possible generalizations
Khalid Al Murrani, "How to Write a Good Report",
2008-09
21
Discussion
Opinions
can be mentioned
Shows what new things were learned from
the experiments/data
No new results? Replication.
What is the relevance of the present results
what did we learn?
Explain, analyze, interpret, compare
Mention the things that are not readily
observable from the data
Khalid Al Murrani, "How to Write a Good Report",
2008-09
22
Conclusions
What
23
Acknowledgements
Thank
work
Thank any sponsoring organizations
Thank any external reviewer
Do not thank relatives and friends
24
References
All
Reference
25
References
26
References
27
Appendices
Additional
Non-essential
to comprehension
Further clarify report
Each appendix should contain different
data/information
Appendices should be referred to in the text
Khalid Al Murrani, "How to Write a Good Report",
2008-09
28
Style
Paragraph
Tense
Passive
Avoid use of pronouns (I, we, you, )
Khalid Al Murrani, "How to Write a Good Report",
2008-09
29
Style
Numbering
Number
all pages
Number all headings except abstract
Hierarchical numbering of headings
Avoid
repetitions
Use formal and impersonal language
Use a consistent style
30
Style
Respect
the structure
Use the standard model unless there is a
strong reason for not doing so
several radically different parts split up
methods, results (and maybe discussion) per part
Advantages of standard model
E.g.
Helps
31
Grammar
Should
be impeccable
Spelling also
Articles
Use
short sentences
Khalid Al Murrani, "How to Write a Good Report",
2008-09
32
General recommendations
Be
as brief as possible
Avoid unnecessary abbreviations
Know your audience
Dont repeat the things the reader knows
Remove
33
General recommendations
The
34
General recommendations
Proofread
35
General recommendations
A
36
Summary
37
Bibliography
UNiM Library:
38
Bibliography
Web:
39