The Mandatory Writing Check-List

General Checks

  • Do you summarize your contribution in the introduction?
  • Is the bibliography consistent? (If you abbreviate first names once, do it all the way through. If you have page numbers once, have page numbers throughout.)
  • Is the spelling of all proper names correct? You would hate to get your paper reviewed by someone who would find his name misspelt in your paper.
  • Are the captions correct? Do you put the table caption before or after the table? Do you put the figure caption before or after the figure? Do you center captions or not?
  • Do you refer to a figure as “Fig. 1″ or as “Figure 1″? Which one is correct?
  • Are all internal references correct? If you refer to Fig. 10, does Figure 10 exists? (Some LaTeX package can mess this up, so always check!) Are all tables and figures referenced in the text?
  • If this is a recurring conference or a journal, have you compared your paper with ten or so other articles to make sure that yours is consistent with how these other papers look and feel? For example, if all published articles use 10 pages for the introduction, make sure you do too.
  • Do you use the right fonts? Be watchful: sometimes the font for the section header can differ from the font used in the main text.
  • Avoid unnecessary lines and borders. Tools like Excel tend to put black borders around figures: get rid of it.
  • It is a great idea to use color where appropriate, especially when you expect your readers to read the electronic version of your document. However, you should not use color unnecessarily: tools like Microsoft Word tend to put all hyperlinks in blue, is this really necessary? Moreover, you should make sure that people can print your paper (in black ink) and still understand the content.
  • If you have collected data or written software, have you tried making it available online?
  • Do you know your story-line? Before you start writing, write your story-line on a napkin!
  • Try to build up your story like a funnel: start with a broad introduction that makes sure EVERYONE understands in which field you are and what you're talking about. THEN zoom in onto your problem and go into the details.
  • Is your Table of Contents well-balanced?
  • Be sufficiently repetitive: say what you are gonna say, say it, say what you have said.
  • Try to structure your paper such that sections have the same length. Use proper structure (at least introduction, motivation, and conclusion should be present)
  • Did you draw the bigger picture (e.g in introduction, conclusion, discussion)?
  • Is the introduction & conclusion understandable for a beginner in the field? Have you explained all basic concepts?
  • In Theses: Have good future work sections. In papers, do not go overboard with future work sections.
  • Have someone proof read your thesis -- also and maybe especially for style issues!
  • Is the layout of each page elegant?
  • Did you spell check? (Really! Please do it!)
  • Can you replace some mathematical notation by plain English?
  • Are all terms defined?
  • Is the mathematical notation consistent? (If you use t for time in the first section, do you use t to note the term in the second section?)
  • Are names consistent? If you called an algorithm Bozo3 in the introduction, don’t call it BOZO-3 in the conclusion.
  • Do the title and the abstract invite the reader to read the rest of the paper?
  • Do you summarize your contribution in the introduction?
  • Is the bibliography consistent? (If you abbreviate first names once, do it all the way through. If you have page numbers once, have page numbers throughout.)
  • Is the spelling of all proper names correct? You would hate to get your paper reviewed by someone who would find his name misspelt in your paper.
  • Are the captions correct? Do you put the table caption before or after the table? Do you put the figure caption before or after the figure? Do you center captions or not?
  • Do you refer to a figure as “Fig. 1′′ or as “Figure 1′′? Which one is correct?
  • Are all internal references correct? If you refer to Fig. 10, does Figure 10 exists? (Some LaTeX package can mess this up, so always check!)
  • Are all tables and figures referenced in the text?
  • If this is a recurring conference or a journal, have you compared your paper with ten or so other articles to make sure that yours is consistent with how these other papers look and feel? For example, if all published articles use 10 pages for the introduction, make sure you do too.
  • Do you use the right fonts? Be watchful: sometimes the font for the section header can differ from the font used in the main text.
  • Avoid unnecessary lines and borders. Tools like Excel tend to put black borders around figures: get rid of it.
  • It is a great idea to use color where appropriate, especially when you expect your readers to read the electronic version of your document.
  • However, you should not use color unnecessarily: tools like Microsoft Word tend to put all hyperlinks in blue, is this really necessary? Moreover, you should make sure that people can print your paper (in black ink) and still understand the content.
  • If you have collected data or written software, have you tried making it available online?
  • Does it say clearly what our contribution is? Reviewers are lazy, they do not want to have to figure out what your message is. Spend some time telling us exactly what your contribution is. Spell it out, do not assume we will read the paper carefully.
  • Do I have original examples and original data sets?
  • Do I have sufficient experimental evidence?'' You need to confront your idea with the real world and report on how well it fares. Compare explicitly your results with the best results elsewhere.
  • Does it contain weak unnecessary results? If you derived ten theorems but only one is necessary, throw the rest of them in your drawers. We do not want to know about useless results!
  • Is it marred by the technical details? Technical papers made of several small ideas are usually uninteresting. Similarly, we are not interested how many seconds it took on your i386 computer from 1990s or longer ago.
  • Do I have a picture summarizing the approach? Really, even if you feel silly doing it or that you think you can’t draw. A picture can help tremendously in communicating difficult ideas.
  • A sexy start: tell the reader early why he should read your paper. Don’t summarize, sell! A good abstract tells us why we should read this paper, it does not summarize the paper. Convince us early that your paper is important. For example, the Kent Beck recipe for a good 4-sentence abstract is: (1) state the problem (2) say why it is interesting (3) say what your solution achieves (4) say what follows from your solution.
  • You should clearly say what your contribution is. Reviewers are lazy, they do not want to have to figure out what your message is. Spend some time telling us exactly what your contribution is. Spell it out, do not assume we will read the paper carefully.
  • A review of related work in the introduction: you can relate your own contribution to all of the related work.
  • A large reference section: people like to be cited, so make sure you cite every paper that might have some relevance.
  • Experimental evidence: you need to confront your idea with the real world and report on how well it fares. Compare explicitly your results with the best results elsewhere.
  • Acknowledge the limitations of your work.
  • Relevant and non-obvious theoretical results: it is easier for people to build on your work if there is some theory.
  • Pictures! Really, even if you feel silly doing it or that you think you can’t draw. A picture can help tremendously in communicating difficult ideas.
  • Original examples over original data sets.
  • A conclusion telling us about future work and summarizing (again) the strong points of the paper.

Text

  • Make text structure/ToC apparent in text (use transition words & phrases). Try to keep a flow in your text, i.e., do not jump from one topic to the next without proper transitions.
  • No empty transition sections! If a section has subsections, add text before the first subsection to give an overview of what you will be discussing in the following subsections.
  • Try to motivate every step you are explaining it!
  • Have you run a spell check? No typos, please!
  • Has somebody read it for grammar mistakes? Have you used a grammar checker?
  • Does every sentence have a crisp statement? Have you been too wordy?
  • Does every statement have a citation?
  • Does a noun follow on every "This" like in "This NOUN is right there..."? Are there proper citations after every statement?
  • Keep sentences short! Have you applied Occams Razor to every sentence? Be to the point = concise!
  • Are you consistent with the tense?
  • Do you state all relevant parameters used for your experiments?
  • Use commas or dashes (--) everywhere where you want the reader to stop briefly and think.
  • Does one of your sentences clearly embody read exactly like one of your thoughts or ideas? If yes, consider making it into two sentences. It usually takes two sentences to convey one idea to another person.
  • Be prepared to remove even the most beautiful of sentences if it makes the paper as such better!
  • Make sure you do not discuss a concept that you introduce properly only later on in the paper. It often happens when rearranging papers! Check the flow between paragraphs of text.
  • Do you have a reference for everything?
  • Do you have widows or orphans? http://www.acm.org/sigs/publications/sigfaq#a19

Bullet Points, Description Lists, etc

  • (Before the first and) after the last bullet point is always a sentence --- it never ends a paragraph or a section!
  • Avoid bullet points but numbered or description lists are OK!

Section Headings

  • Are you using consistently British or American capitalization? (“Our Methodology” versus “Our algorithm”)
  • Are they conveying what we will find in the sections?

Figures

  • Do you have at least one figure?
  • Does your robotics paper have a robot on its front page?
  • Do the figures look nice? Are the fonts in your figures large enough for easy browsing? Are the figures readable once printed out in black-and-white? Can we see any compression artifacts? Prefer vector graphics for your figures. Avoid screen shots unless absolutely necessary.
  • An interesting picture on the first page can be just as informative about the contents of the paper as the abstract.
  • Do all graphs have standard deviation bars?
  • Do you refer to all figures in the text?
  • Have you used the right font and font size in the figures? No [h] parameters in your text.
  • Try to have figures at the top of pages and spaced out over multiple pages.
  • For small figures, use wrapfig!
  • No Pixeled Graphics unless its a photo! Use PDF or EPS not JPEG, GIF, or BMP!
  • Do you have the correct ordering of your graphs according to their reference in the text?
  • The captions of the figures always need to explain the figure --- use a lot of text. Do not rely on the reference of in your text to explain a figure. No white-space around figures -- use wrapfig!

Good Equations

  • No Fractions $\frac{a}{b}$ in the text but always $a/b$.
  • Do not use large symbols (e.g. sum) in equations in the text inline!
  • Mention variables by name and parameter; e.g., " the width w and height h".
  • Explain ALL variables and all equations.
  • Equations, even if in a separate line, are embedded in the text. Thus, proper punctuation ("," or ".") should always be used.
  • Only use numbers for relevant equations
  • Do not use "*" for multiplication.
  • For vectors and matrices, always use bold font.
  • Do not use small brackets for large symbols, e.g. ( \sum blabla ) but \left ( \sum blabla \right)
  • Use "\mathrm" for all mathematical symbols which are not known by latex. Do not use standard math-font! log reads as l * o * g and not as log.
  • After an equation is always a sentence --- it never ends a paragraph or a section!
  • Never ever use x * y as this means convolution \int x(t)y(t-\tau) d\tau Never use \cdot -- we are not in high school.

Algorithms

  • Use a proper package and pseudo-code!
  • Do you have a step-by-step toy example for every new algorithm being introduced? Present your examples early.

Pages and page limits

  • Never exceed the page limit!
  • If the page limit is x pages, do you have an x pages long paper? Some reviewers feel you should use all the pages you were granted.

Format

  • Are references and citations formatted properly (e.g. look at Bibtex errors)?
  • If you refer to equations or section with a number (e.g., Section 4 ), always use upper case.
  • References to Equations should always come in brackets, e.g., Equation (4).
  • Use consistent capitalization for your headings (British vs American = German)