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 threshold 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.
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.
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.
Not like this
But like this
Or use author-year style
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
Treat your LaTeX document like you treat programs: the source code should be accessible (readable) like the source of your programs should be accessible. Thus, use proper layout to clarify the structure of the document.
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.
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’