Advice on writing UG4 and MSc project reports

Goals of this page

This page contains advice that I find myself giving repeatedly to students writing honours and MSc project reports. Reading it should help you with the content and organization of your report, especially the introduction.

In addition to reading this page, make sure you know the assessment criteria! As you are writing and editing your report, ask yourself: have I addressed these criteria?

The introduction

This is often the section that students have the most trouble getting right, perhaps because they are not sure (or are misguided) about what should be in it.

Your introduction needs to answer the following questions (not necessarily in this order):

  1. What is/are the goal(s) of your project?
  2. Why are these important? (Motivation for the project)
  3. How did you go about tackling the goal(s)?
  4. What did you actually achieve/what are your results?

Of course, you may also need to include a few other things like explaining some terminology or a small amount of high-level background information so that you can answer the above questions without losing the reader, but answering the questions should be the main point. I'd expect it might take 2-4 pages to properly address these questions.

The introduction should only spend time defining terms and discussing related work just enough to be able to answer the above questions. Any additional background information should go in the following Background chapter.

Also, as noted in the official UG4 project report guidance:

"This chapter [introduction] should include a clear and concise summary of your contributions (examples: adapting a suite of existing code; interpreting a theoretical algorithm; coding; testing; conducting an experiment) preferably as a bulleted list".

These may be a combination of points from questions 3 and 4 above which you can summarize as the bulleted list.

Sectioning, transitions, and main points

Be wary of using very large numbers of very short sections, and/or using section headings as a crutch to indicate the structure of the document. The section headings may make sense to you, but by themselves they are often insufficient to make the document structure clear to the reader; instead you should make sure the text itself includes transitions, introductions, and/or conclusions that clarify its structure, giving the reader a sense of direction. Consider what would happen if you removed the section headings. Would the document make any sense? A clearly structured document ought to. Crucially, you need to make sure that the main point of each section is clearly stated (i.e., why have you included that section in the document? What is it supposed to tell us?), and that this point is clearly related to what came before (and often, what will follow).

Normally, the main point of each section and the transitioning/context information should come as an introduction to the section, which could be just a sentence or two for short (sub)sections or could be much longer. Introductions may or may not have explicit section headings--usually you would only put a section/chapter heading on an introduction at the beginning of a full paper, or (for a multi-chapter document) at the beginning of the whole document and each chapter. Otherwise it should be:

\section{A}
text introducing main point and how the subsections relate to this point
\subsection{B}
stuff 1
\subsection{C}
(relationship of C to B and/or to the main point of A)
stuff 2
...

In addition, for any medium or large section of a long document (including sections shorter than a full chapter), consider: would it help the reader to include a conclusion that reminds them what the main point of the section was and again fits things into the context of the larger chapter/document (often including what are the missing pieces that the following sections will fill in?). The conclusion doesn't have to be a separate section, it could just be a couple of sentences at the end.


Last modified: Wed, May 21, 2014 3:53:24 PM