HOW TO WRITE A RESEARCH PAPER
A guide for software engineers & practitioners
Adrienne Porter Felt & Kurt Thomas
A research paper is a self-contained technical document that teaches a busy and skeptical person something new.
A research paper is not a blog post, design doc, or post mortem. There are significant differences in content, structure, and tone.
Publishing is a way to demonstrate a commitment to transparency, a high standard of excellence, and advancing science.
Having a PhD is not a requirement to do or publish research. Many engineers do publishable research. However, getting a PhD teaches you how to navigate the publishing game. Here are a few tips to get you started.
CONTENT
STRUCTURE
SKEPTICISM
REVIEWS
What makes a good research paper?
A paper that is very novel might require less evaluation, and
vice versa. However, most successful papers have some of both.
Novelty | The paper needs to contain a new idea. Incremental works are difficult to publish. |
Evaluation | The idea needs to be evaluated. This might be a mathematical proof, proof of concept, or experiment. |
Presentation | You need to explain your idea and evaluation. |
Industry papers are often weak on novelty.
A description of a system or data set is not a research paper. (That’s documentation.) A research paper also needs to teach the reader something new about the world.
Evaluation requires extra effort.
In industry, evaluation usually only goes as far as necessary to launch it. Published papers go further, ideally to rigorous standards.
Leverage industry advantages
Examples
Paper thesis | Unpublishable paper | Good paper candidate |
Which UI is better? | Interview 3-5 employees in a cafe | A/B test with 1M impressions |
I built $THING. | How $THING works | Challenges launching $THING on low-end phones in India |
We have a database of error reports. | Here are all the graphs we made | Top reasons why real world clients can’t connect to Google |
THESIS
STRUCTURE
SKEPTICISM
REVIEWS
Structure your paper so that it’s easy to skim.
Your reader is a busy professional with a long to-do list. Unlike a blog post, people won’t read from top to bottom. They’ll quickly look for one specific figure or hunt around to get the gist.
6 WAYS TO ADD STRUCTURE
1. Follow paper formatting conventions
Not every field uses exactly this structure. Check out papers in your field to understand your specific field. This is just meant as a primer.
1. Follow paper formatting conventions
Introduction structure:
1. Follow paper formatting conventions
Look at papers in your field to see what subsections are expected, e.g., Limitations, Ethics, Performance.
1. Follow paper formatting conventions
In some fields, this is at the beginning near the “Background” section.
1. Follow paper formatting conventions
Here’s a good place to discuss future work.
You should be able to describe your paper’s central research question in a sentence to another expert. Put that sentence in your abstract and introduction.
2. Have a clear, concise thesis
Example 1
Example 2
The abstract, intro, and conclusion should all clearly say what you did and why it’s interesting.
3. State your paper’s contributions
Example 1
Example 2
4. Use bulleted lists and labeled paragraphs
Labeled text helps people find what they’re looking for when skimming, or skip uninteresting paragraphs.
Example 2
Example 1
Example 2
5. Put important numbers into figures
It’s easier to spot key numbers in a table or graph than to have to read through the text for the numbers.
In the text...
...pulled into a figure
6. Use the right tools
Structure is extra important if English isn’t your first language. Structure will help the reader follow your point even if there are grammatical errors or the sentences sound awkward.
THESIS
STRUCTURE
SKEPTICISM
REVIEWS
Convince a skeptic that your work is trustworthy. The world is full of bad research; prove that yours is good.
Examples of what you have to demonstrate
4 WAYS TO WRITE FOR A SKEPTIC
1. Never assume anything, even if it’s obvious
2. Admit your work’s limitations
3. Compare fairly to related work
4. Provide all information the reader needs
THESIS
STRUCTURE
SKEPTICISM
REVIEWS
In order to publish a paper, you submit it for peer review by a panel of experts. They will decide whether to accept or reject your paper.
Learn how to work with the review process. Although it can be frustrating, you can extract value from the review process.
The publishing process
What does the review process look like?
Who are reviewers?
What do reviewers look for?
How to handle a rejection
In my experience, all papers are rejected for four reasons. The trick is figuring out which reason(s) apply to your paper.
Reasons for rejection
Reading between the lines
Reason | What reviewers will say | How to fix it |
Boring | Incremental; lacks novelty; impractical | Submit to a different audience or find something else to work on |
Technical flaw | Concerns about methodology, biases, etc | Fix the flaw and/or rewrite with a skeptic in mind |
Under-�developed | Nice idea but evaluation is lacking | Do the extra work |
Hard to read | The reviewer misunderstands your paper. | Add structure. (It’s your job to be clear for busy reviewers.) |
GOOD LUCK!
CONTACT US
To suggest additional content,�or to let us know that you found this helpful!
felt@chromium.org, kurtthomas@google.com