Lecture Notes on Scientific Writing in Computer Science

Michael Granitzer (michael.granitzer@uni-passau.de)

License

This work is licensed under a Creative Commons Attribution 3.0 Unported License

About this Lecture Notes

We will cover basics on how a research paper should be structured. I closely follow the concept and ideas that stem from one great source, which i recommend to everyone:

Scientific Writing 2.0 - A Reader and Writer's Guide from Jean-Luc Lebrun

So go and grab the book. Take a look at his website

There is also software accompanying that book called SWAN - the Scientific Writing Assistant. When writing papers/homeworks, use that software to improve your writing.

My lecture notes are just the kick-off to get you started. To really master the subject you need to work through Lebrun's book.

Purpose of your Paper

What is the purpose of a research paper?

As a researcher you are making a contribution. That could be a new algorithm, method, process, insight or bringing together existing work in a new manner. It is to identify something new, that might be interesting for others.

The main purpose of your paper is to describe your contribution and answer the following questions:

  1. What is the contribution?
  2. How is your contribution different to what already exists?
  3. Why is your contribution important and what problems does it solve?
  4. How does your contribution work?
  5. How can others reproduce your contribution?
  6. On what evidences is your contribution based on?
  7. What is the impact of your contribution for the future?

A research paper must be structured around your contribution. The structure must answer the above questions.

The skeleton of your paper

The skeleton of your paper are all headings and sub-headings that give your paper a structure. The are four principles to follow for setting up the structure of a paper (see Lebrun 2011):

  1. The contribution guides the shape of a paper
  2. Headings and subheadings detailing the contribution are grouped together
  3. Title words reflecting your contribution should be repeated in the headings
  4. The structure tells the story of your paper and guides the reader.

**Note:** Never make sub-headings that only contain 1-2 paragraphs.

General elements of the structure

The major elements of your research paper should be

  1. Title - The one sentence that describes your contribution
  2. Abstract - The four sentences that summarize your paper
  3. Introduction - The problem and your contributions to it
  4. Background - the background information (related work, state of the art) relevant for the reader. Sometimes this can be integrated in the introduction
  5. Contribution - Use sub-headings to group your contribution. You might use more than 1 section for your contribution, but make it clear why.
  6. Results and discussion
  7. Conclusion - Summarize and conclude the major contributions. Point out the possible impact on the future.

The Title

The title summarizes your contribution in one sentence.

The title is the part which potential readers will see first. Based on your title they decide to take a closer look or to continue their search. The potential reader also gets a first idea on what your paper is about and the potential impact of your contribution. It also sets the expectations, that need to be fulfilled.

A title should be

  • Unique - so that it differentiates from others
  • Concise - so that it is fast to read and understand
  • Clear - so that it is easy to read and understand for the relevant community.
  • Honest and Representative - it sets the expectations of the reader
  • Catchy - so that the reader gets motivated
  • Easy to find - so that the reader can find it in the first place

The Abstract

After the title, the abstract is the second most read part of your paper. It is a paper in the nutshell and should summarize the paper in very few words. It is the second decision point for the reader to dwell into your paper or not.

An abstract has 4 to 5 parts:

  1. Part 0 - the Background: Only if it is necessary or if you have enough space, start with a sentence that sets the background. Most often this part is omitted
  2. Part 1 - the Problem: Explain the problem, topic and aim of the paper (1-2 sentences)
  3. Part 2 - the Solution: Explain how you solved the problem (1-2 sentences)
  4. Part 3 - the Results: Explain the results obtained. That is the most important and largest part of the abstract (1-2 sentences)
  5. Part 4 - the Impact: Explain the impact of the results and how well the problem could be solved.

A good abstract

  1. is representative, i.e. it states the contribution and sets the expectations. Since the title also contains the contribution the abstract should contain all title words
  2. is complete, i.e. it contains parts 1-4
  3. is concise, i.e. is no longer than necessary
  4. is precise, i.e. describes the contribution accurately
  5. is explicit, i.e. it uses formulations that are unambiguously

The Introduction

The introduction sets the story of the paper. It can be viewed like a funnel that takes on board all readers with different background, motivation and expectations and leads them to your contribution.

An introduction has the following parts:

  1. The motivation introduces the topic and claims the field. Very short.
  2. The problem explains what you want to solve. Examples usually help the reader to create an early, intuitive understanding.
  3. The contribution explain your contributions/solutions to the problems. Make them explicit, i.e. use a bullet point list. This is the most important part of the introduction.
  4. The impact explains why your contribution is relevant.

Properties of a good introduction:

  1. It engages the reader by telling a story (but not your personal research story)
  2. It starts fast and finishes strong
  3. It answers the readers key question
    1. What is the main question addressed by the paper?
    2. Why is it important right now?
    3. What are the main contributions of the paper?
    4. What are the obtained results?
    5. Why should the reader care?
  4. It clearly identifies what your work is by using active, explicit formulations (i.e. "our contribution is...")

The Background

The background contains related work and state-of-the-art in the domain. It basically serves two purposes:

  1. Bridge the knowledge-gap of the reader.
  2. Point out the differences of your contribution to what already exists.

In short papers, the background might be included in the introduction. But beware that the introduction must be short. You might use sub-headings in the introduction to differentiate the background from your motivation.

When writing your background, don't simply list related work. Instead you should bring related work in relation to each other and in relation with your own work.

The Contribution

Since every contribution is new and different, it is hard to define a blueprint. But some general rules are

  • Use expressive, concise and logically ordered headings and sub-headings to structure your contribution
  • Use visuals and examples
  • Before explaining complicated issues, try to foster the reader's intuition through an example first. Alternatively, summarize complex paragraphs through an example
  • Although the contribution covers most of your article, it is the least read section due to its complexity.
  • Most often it is the part that is the easiest to write.

The Results and Discussion

The Results

The results section verifies your contribution. For example, you have developed a new algorithm and you ran some tests (e.g. simulations, synthetic experiments, real-world experiments). In the results section you need to report on the conducted experiments. The reported results must be reproducible, so that fellow colleagues can validate your contribution.

Some properties of the results section:

  1. Describe every parameter, definition or assumption on how you obtained the results
  2. Outline why an experiment provides evidence for a contribution
  3. Report on well known limitations of your experiments. If readers find out limitations on their own, they start mistrusting your work or you.
  4. Report the results as they are. Do not interpret them in the first place.
  5. Use figures and charts.
  6. Be honest and clear. If there are flaws, the (mass of ) readers will find it sooner or later.
  7. Provide links to your code or to the full set of results if possible.

The Discussion

The discussion interprets the results and draws conclusions. Result and discussion might be different sections or subsections, or, when needed, subsequent paragraphs. That depends on the results.

As a core principle:

Discuss how a results provides evidence for a claimed contribution.

The Conclusion

The conclusion summarizes the major findings and outlines open endings of your research. Don't be afraid of open endings, they are the driving force behind science.

Some rules:

  1. Don't copy the abstract. Readers often read the conclusion after the abstract.
  2. Summarize your contribution, but under the assumption that the reader read your paper.
  3. Your conclusion is the part of the paper a reader most likely remembers. It's the last impression. So don't be vague. Be honest, precise and down to the point.
  4. Point out open endings such that other researchers can easily take up your work and improve it. That's science.

Summary (of this Lecture Note)

The structure of a paper is critical to guide your reader. The most important principal is:

Contribution guides the structure, not vice versa.

So the proposed structure is not set in stone. if you have good reasons to deviate from the proposed structure, do it.

To learn about good structures try to incorporate the analysis of the structure in your reading habits:

  1. When opening a paper, scan the headings, sub-headings and visuals. Do you get an idea what the paper is about?
  2. How do good papers compare to the structure proposed here?
  3. How do bad papers compare to the structure proposed here?
  4. Practice, practice, practice

Finally: Grap Lebrun's book and work through it. This lecture notes are just a quick overview. There is much more under the surface.