I have to read many theses, term papers, and draft publications each year. Often I see multiple versions of each. A large amount of my reading energy is spent on reading badly written and typeset material. When I have to correct typos, grammatical mistakes, and ugly typesetting, I cannot think about the research ideas in your paper. "Just ignore the bad writing for now" doesn't work for me. Of course, the occasional typo can slip through, but starting today I will return papers that exceed my threshhold of distraction. On this page I will collect pointers to useful resources on writing, and vent on some of my petty annoyances, so that you know what to avoid when sending me a paper.

Resources

Many colleagues have experienced the same problem and have created good collections of tips. Read these first.

See also my collection of resources on reviewing papers.

Literature

Research requires literature study. In the SLDE group, we use http://researchr.org for collecting references to literature in bibliographies. Using researchr you can build on the bibliographies collected by previous efforts of the SLDE group and you can share the results of your efforts with your peers and successors.

Citation

Not like this

  • citations are not nouns: "In \cite{FooBar89} it is shown ..."
  • citations are not part of words: "The Baz tool\cite{FooBar89} ..."

But like this

  • "As shown by Foo and Bar \cite{FooBar89}, ..."
  • "The Baz tool \cite{FooBar89} ..."

Or use author-year style

  • "Foo and Bar (1989) showed that ..."

Typesetting

  • Include page numbers, when you send a paper for reviewing, either formally to a conference or journal, or informal to a friend or supervisor. That makes their job of referring to your paper a lot easier. Just ignore the official style when composing a draft.

  • Don't get fancy and go overboard with fonts and other clever stuff; spend your energy on writing instead.

  • Use LaTeX to typeset your document. It is very likely that your document will be too ugly to read otherwise, since you don't understand typesetting.

  • Use standard LaTeX document styles. It is very likely that your document will be too ugly to read if you try to make up your own LaTeX style, since you don't understand typesetting

    • For papers: use the style required by the conference or journal you are writing for.
    • For master's theses: use the SERG master's thesis style
    • For PhD theses: no style is formally required, but Bravenboer's thesis style can save you a lot of work
    • For term papers: use the Springer LNCS style
  • Don't use typewriter (courier) for the body text of a document.

  • Capitalize the words in section headers

  • Paragraphs should start with an indentation. In LaTeX paragraphs should be separated by a blank line, not by a line break (\\)

  • balanced sections; not too short or too long; all sections should be comparable in length; same for subsections, paragraphs

  • don't overdo nesting

  • Use LaTeX's section hierarchy: section, subsection, paragraph. More levels of nesting are probably a bad sign

  • A 50+ page thesis should have a table of contents, a paper of 20 pages or less, should not.

Writing

  • There is no excuse not to use a spellchecker.

  • Double negations are probably not a good idea.

  • Don't use contractions. They're just not part of academic writing.

  • Avoid parentheses (If a remark is not relevant, why include it at all?)

  • Like vs Such As: usually you should use 'such as'

Common Errors

  • A lot of -> many
  • Therefor -> Therefore
  • there are
Created November 16, 2011 | Last modified April 15, 2014 | Contributions by Eelco Visser