How to write

[Intended primarily for students writing their senior theses.]

Sections

Your Front Matters

In your Front Matter:

  • Include an abstract, table of contents, full list of references.
  • You can include acknowledgements and thank colleagues and friends -- anyone who gave you support
  • You can even dedicate this to someone if you like
  • You can have a short abstract (quarter page) and a longer executive summary (two pages). Abstracts should give brief motivation and also main findings. Remember findings can be positive and negative--- if you find that the data simply does not support some intuitively plausible or commonly believed proposition that is big news; don’t bury that.

Tables of Contents

  • Number all sections. In latex using \section{}; in R markdown using #, ## ; in Word using “Heading 1” “Heading 2” styles – and setting the number to be of the form 1, 1.1, 1.12, 1.2, 2 etc these all can be used to generate automatic table of contents. No handcrafting of numbering or of Tables of Contents.

Introductions

You likely all have to rewrite your introductions. The end of your introductions should say what you find. Given the abstract, exec summary, and intro the reader should have no doubt about where things are going by the time they get into it. Doing this lets readers evaluate your claims more quickly and more directly; it shouldn’t be a puzzle for the reader to figure out your conclusion and your key points should not come as a surprise in the last pages.

Theory Chapters

A good structure for a formal theory chapter is this:

  1. Motivate the model. Why do we care?
  2. Describe the model formally, this requires a full description of (a) the players – how many are they? What are their roles  (b) the strategies – what choices do they have (c) the preferences. In addition this may require a description of the sequence of moves and the information available to all players.
  3. The game description should normally include all parameters of interest including any for which you plan to take comparative statics.
  4. Provide key results in the form of formal propositions. Eg Proposition 1: “under the following conditions (eg all groups are of size ….) the following strategies (…) form an equilibrium.” Primary propositions often describe a particular equilibrium, describe the uniqueness or non-uniqueness of equilibriums, or describe properties of equilibriums.
  5. Give formal statements of propositions on comparative statics (Y is higher when Xis high).
  6. End the chapter by turning these comparative statics claims into empirical hypotheses
  7. This leads naturally on to subsequent chapters.

Empirical Chapters

Whether empirical chapters are quantitative or qualitative they should lead off with a description of your strategy. What are you looking for to find evidence in favor or against a proposition. This strategy is often laid out in earlier chapters (for many people, in chapter 2) but there should still be a recap here. For a quantitative analysis the standard ordering (whether in one chapter or many) is:

  1. Describe hypotheses
  2. Describe measures
  3. Describe tests
  4. Describe core results
  5. Interpret results substantively
  6. Describe robustness
  7. Describe any extensions
  8. Draw overall inferences

If divided into chapters you might have 1-3 in one chapter, 4-5 in a second, 6-7 in a third and 8 in a conclusion.

For a qualitative thesis the elements might be:

  1. Strategy
  2. Description of case selection process
  3. For each case:
    1. General description
    2. Describe how case relates to general model (eg discuss residuals, or the estimated contributions of different factors to the outcome in the case)
    3. Discuss X and Y for case if relevant (are measures measuring what we thought they were)
    4. Describe within case evidence (eg are we seeing what we expect to see if theory is right)
  4. Summary of evidence across cases, maybe gathered together in a single table.
  5. Conclusion

These will vary depending on your project.

Conclusions

You can loosen up in the conclusion a bit to describe possible implications of your work in your domain or other domains. Draw linkages with other work and point to gaps in knowledge. While there is some value in speculation, this does not mean that you should make claims that are not supported by your analyses.

 

2 Presentation

Know your tools

Microsoft Word is fine for lots of writing but for technical writing it is worth investing is learning LaTeX -- a free system for preparing documents. For real transparency it is good to integrate your analysis with your writing. This can be done in various ways but the simplest might be Rmarkdown. Be prepared to learn these new tools.

Style

Your aim in writing is to communicate your results as faithfully as possible not to communicate your process faithfully (of course you have to be transparent about how you did your analysis). It’s normal to go in circles as you develop your thinking on a topic but you do not have to bring the reader in the same circles. Instead try to think about what presentational structure would make it easiest for readers to understand your work quickly. Never try to make things seem more complicated than they are.

A couple of pointers on style:

Keep writing tight

Remove unnecessary flab at the beginning of sentences: “In order to” “I am now going to talk about” “I would argue that”; “It should therefore come as no surprise that” à (try: “Unsurprisingly”)

Remove unoriginal flower: “much ink has been spilled,” “hardly a day goes past”

Formality:

Keep the writing formal: No contractions in formal writing (it’s, that’s, etc)

Royal wheez:

Saying “we’ for a single authored piece can be a little weird. It works for sentences that implicates the reader or the disciplines (“we see from this figure…”, “we know that X causes Y”)

Math:

Get math formatting right. In particular never start a sentence with math; always have math in italics. So not “x denotes commodities” but “We use x to denote commodities.” Use the equation editor in word or if you have a lot of math use LaTeX.

Hyperbole:

Avoid superlatives: vast, massive, extraordinary

Remove; “necessarily” (“while we do not necessarily argue…”)

Remove: “important”, “importantly” (let the reader decide)

Don’t overclaim – if you are arguing that X causes Y don’t call this “my theory”; it is an empirical claim not a theoretical claim. Don’t use “prove” unless you mean an analytic proof – empirical tests never prove anything. Be especially careful about null results – a null result means that you cannot reject the null of no effect, not that you have proved that there is no effect.

Avoid common writing errors:

The past tense of lead is led, not lead

Get “affect” and “effect” right

Get “advise” and “advice” right

Get “its” and “it’s” right (hint: never use “it’s”; use “its” and “it is”)

“Question begging” is a technical term; use it if you know what it means; if you just mean “raises the question” say “raises the question.”

Tables

  • Tables and figures should be in the main body of the text, not at the end (unless they are only meant as extra material).
  • Tables and figures should be numbered and captioned/titled, in most cases. You can do automatic numbering word using “captions”, and in Latex using \caption{}
  • If it’s a table call it a table, don’t call it a figure
  • Tables and other output should NOT be presented as Stata output or other raw output.
  • Coefficients should be arranged in rows with comprehensible and consistent variable names
  • standard errors should be shown in parentheses (or you should note what measure of uncertainty you are displaying if it is not standard errors)
  • include descriptive statistics like number of observations (N) and R-squared should be included.
  • Make sure to say what the dependent variables is
  • Useful also to show how a table result links to a hypothesis.
  • You do not however have to report everything in your tables. For example you do not have to report the values on all control variables if they are not of interest. Table writing is like writing – you should set the tables up so that they communicate the key information as clearly as possible.
  • Precision: numbers should normally reported to two significant digits. Eg 0.12 not 0.000121313245
  • Bottom line: It's often useful and legitimate to give the bottom line of a table at the bottom of the table: "Table shows that there is no evidence that democracy causes growth"

Figures

When possible use figures rather than tables. Figures can give the same information as tables but in a more immediate way. When they show distributions of individual data points they often provide much more information.

References

Use APSR citation style (www.apsanet.org/portals/54/apsa%20files/publications/apsastylemanual2006.pdf)

If working in rmarkdown or latex, use bibtex for this

Other formatting

-Don't forget page numbers! Really.

-Most formatting, like font size and margin size, as well as citation style etc. are up to you, as long as you are consistent. However single or 1.5 spacing is easier on paper; and larger font is easier on the eyes. A good standard is 12 point font, 1.5 spacing, and moderate margins.